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Introduction 



Using the as assembler, you can write assembly language programs for Series 
300/400 computers that use the MC680a;0 family of processors. In addition, as 
can assemble programs that use MC68882; math coprocessors or the HP 98248 
floating-point accelerators. This manual describes how to use as. 

This chapter describes: 

■ This manual's contents. 

■ Related documentation. 

■ Differences in assembler notation. 

■ Using the assembler command. 

■ Using the compilers to invoke the assembler. 

■ Summary of assembler operation. 
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Manual Contents 

Chapter 1: Introduction identifies related manuals, lists various precautions 
related to using as, describes how to invoke as and use its different command 
options, shows how to invoke as from C and FORTRAN compilers, and 
summarizes how as operates. 

Chapter 2: Assembly Language Building Blocks discusses the basic building 
blocks of as assembly language programs: identifiers, register identifiers, and 
constants. 

Chapter 3: Assembly Language Syntax describes the syntax of as assembly 
language programs and introduces labels, statements, and comments. 

Chapter 4' Segments, Location Counters, and Labels discusses the text, data, 
and bss segments, and their relation to location counters and labels. 

Chapter 5: Expressions defines the rules for creating expressions in as 
assembly language programs. 

Chapter 6: Span-Dependent Optimization describes optional optimization of 
branch instructions. 

Chapter 7; Pseudo-Ops describes the various pseudo-ops. Pseudo-ops can 
be used to select a new segment for assembly output, initialize data, define 
symbols, align the assembly output to specific memory boundaries, set the 
rounding mode for floating point input, and set the floating point co-processor 
id. 
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Chapter 8: Address Mode Syntax defines the syntax to use for various 
supported addressing modes, gives hints on using various addressing modes, 
and discusses how as optimizes address formats and displacement size. 

Chapter 9: Instruction Sets describes instructions sets for the MC680a:0 
processors, the MC6888a: floating-point coprocessors, and the HP 98248 
floating-point accelerator. 

Chapter 10: Assembler Listing Options describes use of the as listing options 
-a and -A. 

Appendix A: Compatibility Issues discusses issues to consider if you wish to 
write code that is compatible among MC680a:0 processors. 

Appendix B: Diagnostics provides information on diagnostic error messages 
output by as. 

Appendix C: Interfacing Assembly Routines to Other Languages describes 
how to write as assembly language routines that call or are called from C, 
FORTRAN, and Pascal languages. 

Appendix D: Examples contains examples of as assembly language source code. 

Appendix E: Translators describes translators which convert PLS (Pascal 
Language System) and old Series 200/300 HP-UX assembly code to 
as-compatible format. 

Appendix F: Unsupported Instructions for Series 300s provides information on 
MC680a;0 instructions that are not supported by various Series 300 machines. 

Appendix G: adb shows how to use the assembler debugger, adb, to debug core 
files. 

Appendix H: atime describes the use of the atime facility for timing assembly 
language code. 
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Related Documentation 

This manual deals mainly with the use of the as assembler. This manual does 
not contain detailed information about the actual instructions, status register 
bits, handling of interrupts, processor architecture, and many other issues 
related to the M680a:0 family of processors. For such information, you should 
refer to the appropriate processor documentation for your computer. 

Processor-Specific Manuals 

The following manuals are useful, depending on what processors your system 
uses: 

■ MC68020 82- Bit Microprocessor User's Manual, which describes the 
MC68020 instruction set, status register bits, interrupt handling, cache 
memory, and other issues 

■ MC68030 32-Bit Microprocessor User's Manual, which describes the 
MC68030 instruction set, status register bits, interrupt handling, cache 
memory, and other issues 

■ MC8O4O 32-Bit Microprocessor User's Manual, which describes the MC68040 
instruction set, status register bits, interrupt handling, cache memory, and 
other issues 

■ MC68881 Floating-Point Coprocessor User's Manual, which describes the 
floating-point coprocessor, its instruction set, and other related issues 

■ HP 98248 Floating-Point Accelerator Manual, which describes the 
floating-point accelerator, its instruction set and other related issues. 

Note The reference manuals described above are not provided with 

the standard HP-UX Documentation Set. If you intend to use 
the HP-UX Assembler on your system, you can order these 
manuals from HP. 
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HP-UX Reference 

The HP-UX Reference may also be of interest; the following entries in 
particular: 

■ (25(1) — describes the assembler and its options. 

■ ld{\) — describes the link editor, which converts as relocatable object files to 
executable object files. 

■ a.out{A) and magic{A) — describe the format of object files. 

Programming on HP-UX 

The book Programming on HP-UX contains detailed information on writing 
applications on HP-UX. It covers such concepts as compilers, object files, the 
linker, a. out files, libraries (archive and shared), position-independent code, 
assembly code output by compilers, standard libraries and system calls, and 
language-independent programming tools (such as make and SCCS). 
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Differences in Assembler Notation 

Though for the most part as notation corresponds directly to notation used in 
the previously described processor manuals, several exceptions exist that could 
lead the unsuspecting user to write incorrect as code. These exceptions are 
described next. (Note that further differences are described in Chapter 7 and 
Chapter 8.) 

Comparison Instructions 

One difference that may initially cause problems for some programmers is the 
order of operands in compare instructions: the convention used in the M68000 
Programmer's Reference Manual is the opposite of that used by as. For 
example, using the M68000 Programmer's Reference Manual, one might write: 

CMP.W D5,D3 Is register D3 <= register D5? 
BLE IS.LESS Branch if less or equal. 

Using the as convention, one would write: 

cmp.w y,d3,y,d5 # Is register dS <= register d5? 
ble is_less # Branch if less or equal. 

This follows the convention used by other assemblers supported on UNIX^^ . 
This convention makes for straightforward reading of compare-and-branch 
instruction sequences, but does, nonetheless, lead to the pecuharity that if 
a compare instruction is replaced by a subtract instruction, the effect on 
condition codes will be entirely different. 

This may be confusing to progranamers who are used to thinking of a 
comparison as a subtraction whose result is not stored. Users of as who 
become accustomed to the convention will find that both the compare and 
subtract notations make sense in their respective contexts. 

Simplified Instructions 

Another issue that may cause confusion for some programmers is that the 
MC680xO processor family has several different instructions to do basically the 
same operation. For example, the M 68000 Programmer's Reference Manual 
lists the instructions SUB, SUBA, SUBI, and SUBQ, which all have the effect of 
subtracting a source operand from a destination operand. 
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The as assembler conveniently allows all these operations to be specified by a 
single assembly instruction, sub. By looking at the operands specified with the 
sub instruction, as selects the appropriate MC680a;0 opcode — i.e., either SUB, 
SUBA, SUBI, or SUBQ. 

This could leave the misleading impression that all forms of the SUB operation 
are semantically identical, when in fact, they are not. Whereas SUB, SUBI, 
and SUBQ all affect the condition codes consistently, SUBA does not affect the 
condition codes at aU. Consequently, the as programmer should be aware that 
when the destination of a sub instruction is an address register (which causes 
sub to be mapped to SUBA), the condition codes will not be affected. 

Specific Forms 

You are not restricted to using simplified instructions; you can use specific 
forms for each instruction. For example, you can use the instructions addi, 
adda, and addq, or subi, suba, or subq, instead of just add or sub. A 
specific- form instruction will not be overridden if the instruction doesn't agree 
with the type of its operand(s) or if a more efficient instruction exists. For 
example, the specific form addi is not automatically translated to another 
form, such as addq. 



Invoking the Assembler 

To assemble an assembly language source program, use the as command. Its 
syntax is: 



as 



[options] [file] 



The as assembler creates relocatable object code (a .o file), which can be 
linked (via the Id command) with other object files to create executable 
programs. For details on linking executable programs with Id, see ld{l), or the 
book Programming on HP-UX. 

If any errors are found during assembly, as displays descriptive error messages 
and warnings to stderr. 
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The as command options and source file are described below. Additional 
information can be found in ^^(l). 

Input Source File 

The file argument specifies the file name of the assembly language source 
program. Typically, assembly source files have a .s suffix; e.g., asmprog.s. If 
no file is specified, or if a hyphen (-) is specified, the assembly source is read 
from standard input (stdin). 

Naming the Object File (-o objfile) 

By default, as names the output object file according to these rules: 

■ If the assembly source is read from standard input {i.e., file is not specified or 
is -), then name the output file a. out. 

■ Otherwise, if an input file is specified, name the object file by replacing the 
input file suffix with .o (e.g., source. s becomes source. o). 

To name the output object file something other than the above defaults, use 
the -o outfile option. For example, to assemble a source file named source. s 
and name the resulting object file object.©, use this command: 

$ as -o object.o source. s 

To prevent accidental corruption of source files, as will not accept an outfile 
name ending in .c or .s. Also, as will not accept an outfile name that starts 
with the - or +. 

Generate Assembly Listing (-A) 

Generate an assembly listing with offsets, a hexadecimal dump of the generated 
code, and the source text. The listing goes to standard output (stdout). This 
option cannot be used when the input is stdin. 
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Send Assembly Listing to a File (-a listfile) 

To send the assembly listing to a file instead of stdout, use the -a listfile 
option, where listfile is the name of the file. This option cannot be used when 
the input is stdin. The listfile name cannot end with .c or .s, and cannot 
start with - or +. 

Suppress Warning Messages (-w) 

To suppress warning messages, specify the -w option. 

Include Local Symbols in LST (-L) 

When the -L option is used, local symbols as well as global symbols will be 
placed in the linker symbol table (LST). Normally, only global and undefined 
symbols are entered into the LST. This is a useful option when using the 
assembler debugger, adb, to debug assembly language programs (see the "ADB 
Tutorial" in this book). 

include User-Defined Local Symbols in LST (-1) 

Generates entries in the linker symbol table for all global, undefined, and local 
symbols except those with "." or "L" as the first character. This option is 
useful when using tools like prof on files generated by the C or FORTRAN 
compilers (see prof(l)). It generates LST entries for user-defined local names 
but not for compiler- generated local names. 

Invoking the Macro Preprocessor (-m) 

The -m option causes the m4 macro preprocessor to process the input file before 
as assembles it. For details on m4, see Programming on HP-UX and m4(l). 

Short Displacement (-d) 

The -d option causes as to generate short displacement forms for 
MC68010-compatible addressing modes, even for forward references. 
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Span-Dependent Optimization (-0) 

Turns on span- dependent optimization. This optimization is off by default. 

Set Version Stamp Field (-V number) 

This option causes the a.stamp field in the a. out header (see a.out{4)) to be 
set to number. The -V option overrides any version pseudo-op in the assembly 
source. See Chapter 6. 

As mentioned at the start of this section, as creates relocatable object files. 
Therefore, the .o files created by as use the magic number RELOC^MAGIC as 
defined in the /usr/ include/magic. h header file. The linker. Id, must be used 
to make the file executable. For details on the linker and magic numbers, see 
the following pages from the HP-UX Reference: /c?(l), a.oui(4), and magic{4). 

Generating Position-Independent Object Code (+z/+Z) 

The +z and +Z options generate object files containing position-independent 
code (PIC). PIC object files can be combined with Id to create shared ( -sl) 
libraries. For details on PIC and shared libraries and the use of the +z and +Z 
options, see the book Programming on HP-UX. 

Generating Code for Dynamically Loaded Libraries (+s) 

If +s is specified, as generates code that can be dynamically loaded at run-time 
but cannot be shared. This type of code is combined into archive ( . a) libraries 
with the ar command. See Programming on HP- UX for details on creating 
archive libraries. 
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Invoking the Assembler from the Compilers 

The as assembler can also be invoked through C and FORTRAN compilers. 
Options can be passed to the assembler via the -W a option. For example, 

$ cc -c -W a,-L file.s 

would assemble file.s to generate file.o, with the assembler generating 
LST entries for local symbols. And the command 

$ f77 -o cmd xyz.s abc.f 

compiles abc.f and assembles xyz.s. The resulting .o files (xyz.o and abc.o) 
are then linked to create the executable program cmd. 



Overview of Assembler Operation 

The as assembler operates in two passes. Pass one parses the assembly source 
program. As it parses the source code, it determines operand addressing modes 
and assigns values to labels. The determination of the addressing mode used 
for each instruction is based on the information the assembler has available 
when the instruction is encountered. Preliminary code is generated for each 
instruction. 

Throughout this reference, you will encounter the term pass-one absolute. 

For example, some expressions allow only pass-one absolute expressions. A 
pass-one absolute expression is one whose value can be determined when it is 
first encountered. 

Pass two of as processes the preliminary code and label values (determined 
in pass one) to generate object code and relocation information. In addition, 
as generates a relocatable object file that can be linked by Id to produce an 
executable object code file. If you want to know more about the format of 
object files generated by Id, see ld{l), a.out{4), and a.out{4). 
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Assembly Language Syntax 



This chapter discusses the syntax of as assembly language programs — that 
is, the pieces of assembly language programs and how they fit together. 
Specifically, it describes: 

■ Assembly language source lines. 

■ Labels. 

■ Statements. 

■ Comments. 

■ Identifiers. 

■ Register identifiers. 

■ Constants: 

n Integer 

D Character 

D String 

n Floating-point. 
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Syntax of the Assembly Language Line 

In general, assembly language source lines consist of three parts — label, 
statement, and comment — arranged in this order: 

[ label^ ... [ statement] [ comment] 

Each part is optional (as denoted by the brackets [ j). Therefore, a line can be 
entirely blank (no parts present), or it may contain any combination of the 
parts in the specified order. A line can also have more than one label. 

Labels, statements, and comments are separated by white space (i.e., any 
number of spaces or tabs), and there can also be white space before labels. 



Labels 

A label is an identifier followed by a colon (:). (See "Identifiers" later in this 
chapter.) The colon is not considered to be part of the label. A label can be 
preceded by white space. There can be more than one label per line. (This 
feature is used primarily by compilers.) Here are some example labels: 

Loopl : 
ExitProg : 
.BRANCH. : 

Labels can precede any instruction or pseudo-op, except the text, data, and 
bss pseudo-ops. 
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statements 

A statement consists of an MCSSOxO opcode (or a pseudo-op) and its 
operand(s), if any: 

< - > [ operand \ , operand] ... 1 

[ pseudo-op J "■ '■ •' ■' 

Several statements can appear on the same line, but they must be separated by 
semicolons: 

statement [ ; statement] . . . 

Here are some example statements: 

cmp /CdO , MaxN"um compares data register to value in MaxNum 

beq Overflow branches if they are equal to label Overflow 



Comments 

The # character signifies the start of a comment. Comments are ignored by 
the assembler. Comments start at the # character and continue to the end of 
the line. A # character within a string or character constant does not start a 
comment. Here are some example comments. 

# This comment is on a line by itself. 

LoopO: # This comment follows a label. 

nop # This comment follows a statment. 

Note Some users invoke the C preprocessor, cpp, to make use of 

macro capabilities (see cpp{l)). In such cases, care should be 
taken not to start comments with the # in column one because 
the # in column one has special meaning to cpp. 
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Identifiers 

An identifier is a string of characters taken from a-z, A-Z, 0-9, and _ 
(underscore). The first character of an identifier must be a letter (a-z or A-Z) 
or the underscore (_). 

The as assembler is case-sensitive; for example, loop_35, Loop_35, and 
L00P_35 are all distinct identifiers. Identifiers cannot exceed 256 characters in 
length. 

Identifiers can also begin with a dot (.). This is used primarily for certain 
reserved symbols used by the assembler (.b, .w, .1, .s, .d, .x, and .p). To 
avoid conflict with internal assembler symbols, you should not use identifiers 
that start with a dot. In addition, the names ., .text, .data, and .bss are 
predefined. 

The dot (.) identifier is the location counter, .text, .data, and .bss are 
relocatable symbols that refer to the start of the text, data, and bss segments 
respectively. These three names are predefined for compatibility with other 
UNIX assemblers. (For details on segments, see Chapter 3.) 

The assembler maintains two name spaces in the symbol table: one for 
instruction and pseudo-op mnemonics, the other for all other identifiers — 
user-defined symbols, special reserved symbols, and predefined assembler 
names. This means that a user symbol can be the same as an instruction 
mnemonic without conflict; for example, addq can be used as either a label 
or an instruction. However, an attempt to define a predefined identifier (e.g., 
using .text as a label) causes a symbol redefinition error. Since all special 
symbols and predefined identifiers start with a dot (.), user-defined identifiers 
should not start with the dot. 
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Register Identifiers 

A register identifier denotes a register on an MC680arO processor, MC68881/2 
coprocessor, or HP 98248 floating-point accelerator. Register identifiers begin 
with the */, character. Register identifiers are the only identifiers that can 
use the */, character. In this section, register identifiers are described for the 
following groups of registers: 

■ MC68000 registers, common to all MC680a:0 processors 

■ MC68010 registers, common to the MC68010/20/30/40 processors 

■ MC68020/30/40 registers, used only by the MC68020/30/40 processors 

■ MC68881/2 registers, used only by the MC68881/2 coprocessors 

■ HP 98248 Floating-Point Accelerator registers. 

MC68000 Registers 

Both the MC68010 and MC68020/30 processors use a common set of MC68000 
registers: eight data registers; eight address registers; and condition code, 
program counter, stack pointer, status, user stack pointer, and frame pointer 
registers. 

Table 2-1 defines these registers. 



Table 


2-1. MC68000 Register Identifiers 


Name 


Description 


•/.dO - '/.dT 


Data Registers through 7. 


•/.aO - '/.a? 


Address Registers through 7. 


y.cc 


Condition Code Register 


•/.pc 


Program Counter 


•/.sp 


Stack Pointer (this is %a7) 


y.sr 


Status Register 


y.usp 


User Stack Pointer 


y.fp 


Frame Pointer Address Register (this is y,a6) 
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MC68010 Registers 

In addition to the MC68000 registers, the MC68010 processor supports the 
registers shown in Table 2-2. 

Table 2-2. MC68010 Register Identifiers 



Name 



y.sfc 
y.dfc 

y.vbr 



Description 



Source Function Code Register 
Destination Function Code Register 
Vector Base Register 



MC68020/30/40 Registers 

The entire register set of the MC68000 and MC68010 is included in the 
MC68020/30/40 register set. Table 2-3 shows additional control registers 
available on the MC68020/30/40 processors. 

Table 2-3. MC68020/30/40 Control Register Identifiers 



Name 


Description 


y.caar 


Cache Address Register 


y.cacr 


Cache Control Register 


y.isp 


Interrupt Stack Pointer 


yjnsp 


Master Stack Pointer 



Various addressing modes of the MC68020/30/40 allow registers to be 
suppressed (not used) in the address calculation. Syntactically, this can be 
specified either by omitting a register from the address syntax or by explicitly 
specifying a suppressed register (also known as a zero register) identifier in the 
address syntax. Table 2-4 defines the register identifiers that can be used to 
specify a suppressed register. 
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Table 2-4. Suppressed (Zero) Registers 



Name 


Description 


'/.ZdO - '/.zd? 

'/,zaO — '/.zaT 

y.zpc 


Suppressed Data Registers through 7. 
Suppressed Address Registers through 7. 
Suppressed Program Counter 



MC68881/2 Registers 

Table 2-5 defines the register identifiers for the MC68881 floating-point 



coprocessor. 



Table 2-5. MC6888 1/2 Register Identifiers 



Name 


Description 


•/.f po - y,f p7 


Floating Point Data Registers through 7 


y.fpcr 


Floating Point Control Register 


y.fpsr 


Floating Point Status Register 


y,fpiar 


Floating Point Instruction Address Register 



HP 98248 Floating-Point Accelerator Registers 

Table 2-6 defines the register identifiers for the floating-point accelerator. 
Table 2-6. HP 98248 Floating-Point Accelerator Registers 



Name 


Description 


y,fpaO - y,fpal5 
y.fpacr 
y.fpasr 


Floating Point Data Registers 
Floating Point Control Register 
Floating Point Status Register 
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Constants 

The as assembler allows you to use integer, character, string, and floating 
point constants. 

Integer Constants 

Integer constants can be represented as either decimal (base 10), octal (base 8), 
or hexadecimal (base 16) values. A decimal constant is a string of digits (0-9) 
starting with a non-zero digit (1-9). An octal constant is a string of digits (0-7) 
starting with a zero (0). A hexadecimal constant is a string of digits and letters 
(0-9, a-f, and A-F) starting with Ox or OX (zero X). In hexadecimal constants, 
upper- and lower-case letters are not distinguished. 

The as assembler stores integer constants internally as 32-bit values. When 
calculating the value of an integer constant, overflow is not detected. 

Following are example decimal, octal, and hexadecimal constants: 

35 Decimal 35 

035 Octal 35 (Decimal 29) 

0X35 Hexadecimal 35 (Decimal 53) 

Oxf F Hexadecimal ff (Decimal 255) 

Character Constants 

An ordinary character constant consists of a single- quote character (') followed 
by an arbitrary ASCII character other than the backslash (\), which is reserved 
for specifying special characters. Character constants yield an integer value 
equivalent to the ASCII code for the character; because they yield an integer 
value, they can be used anywhere an integer constant can. The following are all 
valid character constants: 
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Constant 


Value 


'0 
'A 
'a 


Digit Zero 

Upper-Case A 

Lower-Case a 

Single- Quote Character (see following 
description of special characters) 



A special character consists of \ followed by another character. All special 
characters are listed in Table 2-7. 

Table 2-7. Special Characters 



Constant 


Value 


Meaning 


\b 


0x08 


Backspace 


\t 


0x09 


Horizontal Tab 


\n 


OxOa 


Newline (Line Feed) 


\v 


OxOb 


Vertical Tab 


\f 


OxOc 


Form Feed 


\r 


OxOd 


Carriage Return 


W 


0x5c 


Backslash 


\' 


0x27 


Single Quote 


\" 


0x22 


Double Quote 



If the backslash precedes a character other than the special characters shown in 
Table 2-7, then the character is produced. For example, \A is equivalent to A. 
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In addition to the special characters shown in Table 2-7, you can optionally 
represent any character by following the backslash with an octal number 
containing up to three digits: 

\ddd 

For example, \11 represents the horizontal tab (\t); \0 represents the NULL 
character. 

String Constants 

A string consists of a sequence of characters enclosed in double quotes. String 
constants can be used only with the byte and asciz pseudo-ops, described in 
Chapter 6, 

Special characters (see Table 2-6) can be imbedded anywhere in a string. A 
double-quote character within a string must be preceded by the \ character. 

Strings may contain no more than 256 characters. 

String constants can be continued across lines by ending nonterminating line(s) 
with the \ character. Spaxres at the start of a continued line are significant and 
will be included in the string. For example, 

# 

# The following lines start in the first column. 

# 

byte "This\ 

string \ 
contains a double-quote (\") character." 

produces the string: 

This string contains a double-quote (") character. 

Floating-Point Constants 

Floating-point constants can only be used as either: 

■ Immediate operands to MC68881/2 floating-point instructions, or 

■ As the operand of one of the following data- alio cation pseudo-ops: float, 
double, extend, and packed. 
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A floating-point constant starts with Of (zero f ) or OF and is followed by 
a string of digits containing an optional decimal point and followed by an 
optional exponent. The floating-point data formats are described in the 
MC68881/2 User's Manual. The following are examples of floating-point 
constants: 

fadd.d &0fl.2e+02,*/,fpl # the constant is "double" 

# inferred from instr. size (.d) 
float 0f-1.2e3 

The & operator in the floating-point constant example specifies to as that the 
floating-point constant is an immediate operand. For details, see Chapter 4. 

The type of a floating-point constant (float, double, extend, or packed) 
is determined by the pseudo-op used or, for immediate operands, by the 
operation size (.s, .d, .x, or .p). When a floating-point constant is used as an 
immediate operand to an instruction, an operation size must be specified in 
order to define the type of the constant. 

Floating-point constants are converted to IEEE floating-point formats using the 
cvtnum routine. (See the cvtnum{ZQ).) The rounding modes can be set with 
the fpmode pseudo-op. Also, special IEEE numbers can be specified with the 
NAN (Not A Number) and INF (INFinity) syntaxes: 

Ofinf 
OfNan(abcdeeo) 
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Segments, Location Counters, 
and Labels 



This chapter discusses segments, location counters, and their relationship to 
labels. 



Segments 

An as assembly language program may be divided into separate sections known 
as segments. Three segments exist in as assembly language: text, data, and 
bss. The resulting object code from assembly is the concatenation of the text, 
data, and bss segments. 

By convention, instructions are placed in the text segment; initialized data is 
placed in the data segment; and storage for uninitialized data is allocated in 
the bss segment. By default, as begins assembly in the text segment. 

Instructions and data can be intermixed in either the text or data segment, but 
only uninitialized data can be allocated in the bss segment. 

The pseudo-ops text, data, and bss cause as to switch to the named 
segment. You can switch between different segments as often as needed. These 
pseudo-ops are discussed in Chapter 6. 

Note In addition to the text, data, and bss segments, as supports the 

xt, sit, vt, gntt, and Intt segments, which are used primarily by 
symbolic debuggers {xdb{l)). These are generated, for example, 
when the C compiler is invoked with the -g option. These 
segments are mainly for compiler use and are not generally of 
interest to as programmers. 
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Location Counters 

The assembler maintains separate location counters for the text, data, and bss 
segments. The location counter for a given segment is incremented by one for 
each byte generated in that segment. 

The dot symbol ( . ) is a predefined identifier that represents the value of the 
location counter in the current segment. It can be used as an operand for an 
instruction or a data-allocation pseudo-op. For example: 

text 

jmp . # this is an infinite loop 

Or, 

data 
X : long . , . , . 

When allocating data, as in the second example, the location counter is 
updated after every data item. So the second example is equivalent to: 

data 
x: long X, x+4, x+8 # long data items use 4 bytes each 
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Labels 

A label has an associated segment and value. A label's segment is equivalent 
to the segment in which the label is defined. A label's value is taken from the 
location counter for the segment. Thus, a label represents a memory location 
relative to the beginning of a particular segment. 

A label is associated with the next assembly instruction or pseudo-op that 
follows it, even if it is separated by comments or newlines. If the instruction 
or pseudo-op which follows a label causes any implicit alignment to certain 
memory boundaries (e.g., instructions are always aligned to even addresses), 
the location counter is updated before the label's value is assigned. Explicit 
assignments using the lalign pseuo-op occur after the label value is set. 

The following example should help clarify what a label's segment and value are: 

# 

# Switch to the data segment and enter the first initialized 

# data into it: 
# 

data 
x: long 0x1234 # allocate 4 bytes for this number 

byte 2 # allocate 1 byte for this number 

y: # now initialize the variable "y" 

z : long Oxabcd 

Assuming these lines are the first statements in the data segment, then label 
X is in the data segment and has value 0; labels y and z are also in the data 
segment and each has value 6 (because the long pseudo-op causes implicit 
alignment to even addresses, i.e., word boundaries). Note that both y and z are 
labels to the long pseudo-op. 

Padding or filler bytes generated by implicit ahgnment are initialized to zeroes. 
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Expressions 



This chapter discusses as assembly language expressions. An expression can be 
extremely simple; for example, it can be a single constant value. Expressions 
can also be complex, comprising many operators (e.g., +, -, *, /) and operands 
(constants and identifiers). 



Expression Types 

All identifiers and expressions in an as program have an associated type, which 
can be absolute, relocatable, or external. 

Absolute 

In the simplest case, an expression or identifier may have an absolute 
value, such as 56, —9000, or 256318. All constants are absolute expressions. 
Identifiers used as labels cannot have an absolute value because they are 
relative to a segment. However, other identifiers (e.g., those whose values are 
assigned via the set pseudo-op) can have absolute values. 

Relocatable 

Any expression or identifier may have a value relative to the start of a segment. 
Such a value is known as a relocatable value. The memory location represented 
by such an expression cannot be known at assembly time, but the relative 
values of two such expressions (i.e., the difference between them) can be known 
if they are in the same segment. 

Identifiers used as labels have relocatable values. 
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External 

If an identifier is never assigned a value, it is assumed to be an undefined 
external. Such identifiers may be used with the expectation that their values 
will be defined in another program, and therefore known at link time; but the 
relative value of undefined externals cannot be known. 



Expression Rules 

The basic building blocks of expressions are operators, constants, and 
identifiers. Table 4-1 shows all the operators supported by as. 



Table 4-1. Expression Operators 



Op 


Description 




Unary Operators 


+ 


Unary Plus (no-op) 


- 


Negation 


- 


I's Complement (Bitwise Negate) 




Binary Operators 


+ 


Addition 


- 


Subtraction 


* 


Multiplication 


/' 


Division 


el 


Modulo 


> 


Bit Shift Right 


< 


Bit Shift Left 


& 


Bitwise AND 


1 


Bitwise OR 


- 


Bitwise Exclusive-OR 



If the result of a division is a non-integer, truncation is performed so that 
the sign of the remainder is the same as the sign of the quotient. 
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Expressions can be constructed from the following rule: 

expr == const 
id 

unop expr 
expr binop expr 
( expr ) 

where: 

■ const is a constant 

■ id is an identifier 

■ unop is a unaxy operator 

■ expr is an expression 

■ binop is a binary operator 

Note that the definition is recursive; that is, expressions can be built from 
other expressions. All of the following are valid expressions: 

0x7ffa091c 
125 

Default_X_Col 
- 1 

BitMask & 0x3f c9 BitMask must be absolute. 

(0) 

(MinValue + X.off set) * ArraySize MinValue, X_off set, and Array- 
Size must all be absolute. 



Precedence and Associativity Rules 

To resolve the ambiguity of the evaluation of expressions, the following 
precedence rules are used: 



unary + 
* / S 
+ - 
< > 



HIGHEST 



LOWEST 
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Use parentheses ( ) to override the precedence of operators. Unary operators 
group (associate) right-to-left; binary operators group left- to- right. Note that 
the precedence rules agree with those of the C programming language. 

Determining Expression Type 

An expression's type depends on the type of its operand(s). Using the following 
notation: 

■ abs — integer absolute expression 

■ rel — relocatable expression 

■ ext — undefined external 

■ dabs — double floating point constant 

■ fabs — floating point constant (float, extend, or packed). 

The resulting expression type is determined as follows: 

abs binop abs => abs 
unop abs =>■ abs 

dabs binop dabs => dabs (where binop can be +, -, *, /) 
unop dabs => dabs (where unop can be +, -) 

fabs (fabs expressions are limited to single constants) 

abs + rel =^ rel 
rel + abs => rel 
rel - abs => rel 

abs + ext =^ ext 
ext + abs =^ ext 
ext - abs => ext 

rel - rel =^ abs (provided both rel expressions are relative to the same segment) 

Absolute integer constants are stored internally as 32-bit signed integer values. 
Evaluation of absolute integer expressions uses 32- bit signed integer arithmetic. 
Integer overflow is not detected. 
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Note The value of a rel - rel expression can be computed only when 

the values of both rel expressions are known. Therefore, a rel - 
rel expression can appear in a larger expression (e.g., rel - rel + 
ahs) only if both reh are defined before the expression occurs; 
this is so that the assembler can do the subtraction during 
pass one. If either of the reh is not defined prior to a rel - rel 
subtraction, the calculation is delayed until pass two; then the 
expression can be no more complex than identifier - identifier. 

When the -0 option is used to turn on span-dependent optimization, all 
subtraction calculations of text symbols (labels defined in the text segment) 
are normally delayed until pass two since the final segment relative offset of a 
text symbol cannot be determined in pass one. This means that expressions 
involving subtraction of text symbols are limited to identifier - identifier. 
This default can be overridden with the allow.plsub pseudo-op which directs 
the assembler to compute subtractions in pass one even if the symbols are 
text symbols. The difference will be calculated using the (preliminary) pass 
one values of the symbols; the two labels in such a subtraction (labell - 
label2) should not be separated by any code operations that will be modified 
by span-dependent optimization (see Chapter 5 and the description of 
allow.plsub Chapter 6). 

Expressions must evaluate to absolute numbers or simple relocatable 
quantities; that is, identifier [± abs]. Complex relocation (i.e., expressions 
with more than one non-absolute symbol other than the identifier - identifier 
form) is not permitted, even in intermediate results. Thus, even though 
expressions like (rell - rel2) + (rel3 - rel4) are legal (if all xeli are in 
the same segment and defined prior to the expression), expressions such as 
(rell + rel2) - (rel3 + rel4) are not. 

Since expression evaluation is done during pass one, an expression (and every 
intermediate result of the expression) must be reducible to an absolute number 
or simple relocatable form (i.e., identifier [± offset] or identifier - identifier) at 
pass one. This means that other than the special form identifier - identifier, 
an expression can contain at most one forward-referenced symbol. 

For example, the following code stores a NULL-terminated string in the 
data segment and stores the length of the string in the memory location 
login.prompt.length. The string length (not including the terminating 
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NULL) is computed by subtracting the relative values of two labels 
(login_prompt_end - login.prompt) and subtracting 1 (for the terminating 
NULL). This is valid because both labels are defined prior to the subtraction 
in which they are used. 

data 

login.prompt : byte "Login Name: ",0 

login_prompt_end: space 

login_prompt_length: short login_proinpt_end - login_prompt - 1 

The space pseudo-op above causes the label login_prompt_end to have 
the value of the location counter. If this was not included, the label 
would be associated with the following short pseudo-op, which has 
imphcit word- alignment, and which might cause an invalid value in the 
login_proiiipt_length calculation. 

The next code example contains an invahd expression, because: 

1. The expression uses two as-yet-unencountered relative expressions, 
exit_prompt and exit_prompt_len. 

2. The computed expression (exit_prompt_end - exit_prompt - 1) is too 
complex because of the "- 1". Expressions that use as-yet-unencountered 
relative expressions cannot be any more complex than identifier - identifier. 

data 

exit.prompt^len: short ex it .prompt _ end - exit .prompt - 1 

exit.prompt: byte "Good-Bye\n",0 

ex it .prompt .end: space 

To solve this problem, you could rewrite the above code as: 

data 

exit.prompt.len: short ex it .prompt. end - exit .prompt - 1 

exit.prompt: byte "Good-Bye\n",0 

exit.prompt.end: byte 

Notice that the exit.prompt.len expression has been reduced to a rel - rel 
expression, exit.prompt.end - exit.prompt. 
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Pass-One Absolute Expressions 

Throughout this reference you will encounter the term pass-one absolute 
expression. For example, some pseudo-op and instruction arguments must be 
pass-one absolute expressions. A pass-one absolute expression is one which 
can be reduced to an absolute number in pass one of the assembly. A pass-one 
absolute expression cannot contain any forward references. 

Pass-One Absolute Expressions and Span-Dependent Optimization 

A pass-one expression cannot contain any forward references. When the 
-0 option is used, a symbol subtraction of two text symbols (identifier - 
identifier) is not pass-one absolute because all subtraction calculations for text 
symbols are delayed until pass two. This can cause problems in a program 
segment like the following: 

text 
Lstart: long 100, 101 

Lend: lalign 1 # no effect except to define the 

# label Lend. 
Lsize: long (Lend - Lstart) /4 # number of table entries 

Tegment would assemble correctly if the -0 option is not used, but the 
calculation (Lend - Lstart)/4 would give a syntax error if the -0 option is used 
because the expression would be too complex. 

This can be remedied by either moving the table declarations to the data 
segment, or by using the allow_plsub pseudo-op. The allow.plsub pseudo-op 
directs the assembler to perform pass one subtractions where possible even for 
text symbols. The subtractions are performed using pass one values; the labels 
should not be separated by any code that will be modified by span-dependent 
optimization (see Chapter 5 and the description of allow.plsub in Chapter 6). 
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Floating-Point Expressions 

Floating-point constants can be float (single-precision), double, extended, 
or packed. The particular kind of floating-point constant generated by as 
is determined by the context in which the constant occurs. (See the float, 
double, extend, and packed pseudo-ops in Chapter 6.) 

When used with the float, extend, or packed pseudo-ops, floating-point 
expressions are restricted to a single constant; for example: 

float 0fl.23el0 

Double floating-point expressions can be built using the unary operators + and 
-, and the binary operators +, -, /, and *. Double expressions are evaluated 
using C-like double arithmetic. The following shows a double expression: 

double Of 1.2 * Of 3. 4 + Of.6 
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Span-Dependent Optimization 



The MC6805:0 branching instructions (bra, bsr, hCC) have a PC-relative 
address operand. The size of the operand needed depends on the distance 
between the instruction and its target. Choosing the smallest form is called 
span-dependent optimization. 



Using the -O Option 

The assembler -0 option enables span- dependent optimization in the assembler. 
By default, span-dependent optimization is not enabled. (When compiling C 
or Fortran programs using the -0 compiler option, the peephole optimizer 
(/lib/c2) does the span-dependent optimization rather than the assembler. A 
C or Fortran program should not be compiled with the -Wa,-0 option.) When 
the -0 option is enabled, as attempts to optimize the PC-relative offset for the 
instructions shown in Figure 5-1. 

hCC 

bra 

bsr 

fhFPCC (68881/2) 

fpbCC (HP 98248 FPA) 

Figure 5-1. Span-Dependent Optimized Instructions 



Span- dependent optimizations are performed only within the text segment and 
affect only instructions that do not have an explicit size suffix. Any instruction 
with an explicit size suffix is assembled according to the specified size suffix 
and is not optimized. 
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By default, the assembler chooses between .b, .w, and .1 operations. If the -d 
option is specified, as chooses between .b and .w operations; when a .w offset 
is not sufficient, as uses equivalent instructions to provide the effect of a long 
offset. This means that a program that fails to assemble with the -d option 
because of branch offsets that are longer than a word may assemble when as 10 
-0 is used. 

When a branch is too long to fit in the given offset, you will get an error 
message similar to as error: "x.s" line 120: branch displacement too 
large: try -0 assembler option (compiler option -Wa,-0) (with no size 
on branch statement). If you are using as 10 and the offset is already word 
sized, then try using the -0 option and remove the .w suffix from the branch 
instruction. 

Default Optimizations Performed 

Table 5-1 shows the default span- dependent optimizations performed by as (if 
the -d option is not specified on the command line). 

Table 5-1. Default Span-Dependent Optimizations 



Instruction 


Byte Form 


Word Form 


Long Form 


br, bra, bsr 


byte offset 


word offset 


long offset 


hCC 


byte offset 


word offset 


long offset 


fh CC 


- 


word offset 


long offset 


fpbCC 


byte offset 


word offset 


long offset 



Note A byte branch offset cannot be zero (i.e., branch to the 

following address). A br, bra, or hCC to the following address 
is optimized to a nop. A bsr to the following address uses a 
word offset. The FPA fpbCC optimization refers to optimizing 
the implied 68020 branch (see HP 98248 Floating Point 
Accelerator). 
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MC68010-Compatible Optimizations 

If you need to generate code that will run on MC68010 processors, you 
should invoke as with the -d option. Table 5-2 shows the span- dependent 
optimizations that are performed when as is invoked with the -d. This option 
causes the assembler to use addressing modes that are compatible with the 
MC68010 processor. 

Table 5-2. MC680 10-Compatible Span-Dependent Optimizations 



Instruction 


Byte Form 


Word Form 


Long Form 


br, bra, bsr 
hCC 


byte offset 
byte offset 


word offset 
word offset 


jmp or jsr with absolute 
long address 

byte offset conditional 
branch with reversed 
condition around jmp 
with absolute long 
address 



Note A byte branch offset cannot be zero (i.e., branch to the 

following address). A br, bra, or hCC to the following address 
is optimized to a nop. A bsr to the following address uses a 
word offset. 
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Example of Optimization Performed 

Table 5-3 shows original assembly source and the corresponding code produced 
by span-dependent optimization. 

Table 5-3. Effective Code after Optimization 



Ll: add y.dO//,dl LI: 



L2; 



L3; 



L4: 





Original Code 


bcs 


Ll 


add 


y.do,y.di 


bne 


L2 


bra 


L2 


bsr 


L2 


space 


80 


add 


y.do,y.di 


beq 


L3 


bra 


L3 


bsr 


L3 


space 


2000 


add 


y.do,y,di 


bgt 


L4 


bra 


L4 


bsr 


L4 


space 


40000 


add 


y.do,y.di 



L2; 



L3: 



L4: 



Optimized Code 


nop 




add 


y.dO,y.dl 


bne.b 


L2 


bra.b 


L2 


bsr.b 


L2 


space 


80 


add 


y.do,y.di 


beq.w 


L3 


bra.w 


L3 


bsr.w 


L3 


space 


2000 


add 


y.do,y.di 


bgt.l 


L4 


bra.l 


L4 


bsr.l 


L4 


space 


40000 


add 


y.do,y,di 
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Optimization Performed with the -d Option 

Table 5-4 illustrates the optimizations performed when as is invoked with -d 
option. 

Table 5-4. 







Span-Dependent Optimizations Performed with -d Option 






Original Code 




Optimized Code 




bcs 


Ll 






Ll: 


add 
bne 


•/.do,y.di 

L2 


nop 

Ll: add 


y.do,y.di 




bra 


L2 


bne.b 


L2 




bsr 


L2 


bra.b 


L2 




space 


80 


bsr.b 


L2 


L2: 


add 
beq 


'/,dO,y,dl 
L3 


space 
L2: add 


80 

y.do,y,di 




bra 


L3 


beq.w 


L3 




bsr 


L3 


bra.w 


L3 




space 


2000 


bsr.w 


L3 


L3: 


add 
bgt 


y,do,y.di 

L4 


space 
L3: add 

ble.l 
jmp 


2000 

y.do,y.di 

L4x 

L4 #absolute.l addressing 




bra 


L4 


L4x: 






bsr 


L4 


jmp 


L4 #absolute.l addressing 




space 


40000 


jsr 


L4 #absolute.l addressing 


L4: 


add 


y.do.y.d 


space 
L4: add 


40000 

y,do,y.di 
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Restrictions When Using the -O Option 

Several caveats should be followed when using the span-dependent optimization 
option. These are good programming practices to follow in general when 
programming in assembly. 

When the span-dependent optimization option is enabled, branch targets 
should be restricted to simple labels, such as LI. More complex targets, such 
as Ll+10, are ambiguous since the span- dependent optimizations can modify 
instruction sizes. A branch with a nonsimple target may not assemble as 
expected. 

Absolute (rather than symbolic) offsets in PC-relative addressing modes should 
be used only where the programmer can calculate the PC oifset and the offset 
cannot be changed by potential span-dependent optimization. 

Not6 When using span- dependent optimization, limit text segment 

targets to simple labels, such as LI. Nonsimple targets, such as 
Ll+10 or PC-relative addressing with a nonsymbolic offset field 
should be used only when the programmer knows that the code 
between label LI and Ll+10 will always assemble to a fixed size 
and cannot be modified by span-dependent optimization. 



Span-Dependent Optimization and lalign 

When span-dependent optimization is enabled, the assembler will preserve any 
even- sized laligns relative to the start of the text segment. This may result in 
some branch optimizations being suboptimal. 

Only laligns of 1, 2, and 4, however, are guaranteed to be preserved by the 
linker ild{l)). (See "A Note about lalign" in Chapter 6.) 
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Symbol Subtractions 

In normal mode, the assembler calculates symbol subtractions in pass one 
if both symbols are already defined. This allows more complex expressions 
involving symbol differences to be used. 

Table: long 123 
long 234 

long 231 
Tend: lalign 1 # no effect except to define Tend 

Tsize: long (Tend-Table)/4 # number of elements in Table 

When span-dependent optimization is enabled, the assembler normally saves 
all symbols subtractions involving text segment symbols until pass two because 
the symbol values (text-relative offset) will not be known until after pass one 
is complete and span-dependent optimization is performed. This restricts 
expressions involving text symbol differences to identifier - identifier. In the 
example program above, the line defining Tsize would assemble correctly if the 
-0 option is not used but will generate a syntax error ("illegal divide") if 
the -0 option is enabled. 

There are two solutions to this problem. In the above example, the code lines 
could be put into the data segment; span-dependent optimization does not 
affect the rules for calculating symbol differences of data or bss symbols. 

The second alternative is to use the allow.plsub and end_plsub pseudo-ops. 
The allow.plsub and end.pl sub pseudo-ops bracket areas where the 
assembler is directed to calculate text symbol subtractions in pass one 
(provided both symbols are already defined), even though the -0 option is 
enabled. The two text symbols in a difference label 1 - label2 should not be 
separated by any code that could be modified by span- dependent optimization. 
If the two symbols are separated by code that is optimized, the subtraction 
result will be wrong since it is calculated using pass one offsets. 

The following code segment is similar to the code generated by the C compiler 
for a switch statement. It has been modified to calculate a Lswitch.limit 
for the size of the switch table (the compiler generates an in-line constant 
instead). The line defining Lswitch.limit is bracketed by allow.plsub and 
end_plsub so that the subtraction will be done in pass one and the complex 
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expression will be accepted by the assembler. The pass one subtraction is valid 
since labels L22 and Lswitch.end are separated only by long pseudo-ops which 
cannot change in size during span-dependent optimization. 



subq.l 


&Oxl,y.dO 


cmp.l 


•/♦dO ,Lswitch_limit 


bhi.l 


L21 


mov.l 


(L22 , '/.zaO , y,dO . 1*4) , '/.dO 


jmp 


2(y.pc,y.d0.1) 



L23: 

1 align 4 
L22: 

long L15-L23 

long L16-L23 

long L17-L23 

long L18-L23 

long L19-L23 

long L20-L23 

Lswitch_end: lalign 1 

allow.plsub 

Lswitch.limit : (Lswitch_end-L22)/4 - 1 

end.plsTib 
L13: 
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Pseudo-Ops 



The as assembler supports a number of pseudo-ops. A psuedo-op is a special 
instruction that directs the assembler to do one of the following: 

■ Select segments. 

■ Initialize data. 

■ Define symbols. 

■ Align within the current segment. 

■ Floating-point directives. 

■ Span- dependent directives for expression Ccdculation. 

■ Set the a_stamp field in the a. out header. 
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Segment Selection Pseudo-Ops 

You can control in which segment code and/or data is generated via segment 
selection pseudo-ops. Table 6-1 describes the three segment selection 
pseudo-ops. 

Table 6-1. Segment Selection Pseudo-Ops 



Pseudo-Op 


Description 


text 

data 
bss 


Causes the text segment to be the current segment — i.e., all 
subsequent assembly output (until the next segment 
selection pseudo-op) is generated in the text segment. By 
default, assembly begins in the text segment. 

Causes the data segment to be the current segment — i.e., 
any subsequent assembly is placed in the data segment. 

Causes the bss segment to be the current segment. The bss 
segment is reserved for uninitialized data only. Attempting 
to assemble code or data definition pseudo-ops (e.g., long, 
byte, etc) results in an error. The only data-allocation 
pseudo-ops that should be used in the bss segment are 
space and Icomm. 
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An assembly program can switch between different segments any number of 
times. In other words, you can have a program that switches back and forth 
between different segments, such as: 

text 

assembly code for the text segment 
data 

put some initialized data here in the data segment 
bss 

allocate some space for an array in the bss segment 
text 

more assembly code in the text segment 
data 

more initialized data in the data segment 
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Data Initialization Pseudo-Ops 

Table 6-2 lists all data initialization pseudo-ops. Data initialization pseudo-ops 
allocate appropriate space and assign values for data to be used by the 
assembly language program. Data is allocated in the current segment. 

Note For float, double, packed, and extend, conversions are 

performed according to the IEEE floating point standard using 
the cvtnum routine (see cvtnum{3C)). The current value of 
fpmode defines the rounding mode to be used. 



Table 6-2. Data Initialization Pseudo-Ops 


Pseudo-Op 


Description 


byte iexpr\string[, . . . ] 
short iexpr[, . . . ] 


The byte pseudo-op allocates successive bytes of 
data in the assembly output from a specified list of 
integer expressions (iexpr) and/or string constants 
(string). 

The iexpr can be absolute, relocatable, or external. 
However, only the low-order byte of each 
relocatable or external iexpr is stored. 

A string operand generates successive bytes of 
data for each character in the string; as does not 
append the string with a terminating NULL 
character. 

The short psuedo-op generates 16-bit data ahgned 
on word (16-bit) boundaries from a list of integer 
expressions (iexpr). The iexpr can be absolute, 
relocatable, or external. However, only the 
low-order 16-bit word of each relocatable or 
external iexpr is stored. 
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Table 6-2. Data Initialization Pseudo-Ops (continued) 



Pseudo-Op 


Description 


long iexpr[, . . . ] 

asciz string 
float fexpr[, . .. ] 

double fexpr[, . . . ] 
packed fexpr[, . . . ] 
extend fexpr[, . . . ] 


The long pseudo-op generates 32-bit data from a 
list of one or more integer expressions (iexpr) 
separated by commas. Data is generated on word 
(16-bit) boundaries. An iexpr can be absolute, 
relocatable, or external. 

The asciz pseudo-op puts a null-terminated string 
into the assembly output: one byte is generated for 
each character, and the string is appended with a 
zero byte. 

Generates single-precision (32-bit) floating point 
values from the specified list of one or more 
absolute floating point expressions (fexpr). Data is 
stored on word (16-bit) boundaries. Only simple 
floating point constants are allowed. 

Generates double-precision (64-bit) floating point 
values from the specified list of one or more 
absolute floating point expressions (fexpr). Data is 
stored on word (16-bit) boundaries. 

Generates word-ahgned, packed floating point 
values (12 bytes each) from the list of floating 
point expressions. Only simple floating point 
constants are allowed for fexpr. 

Generates word-aligned, extended floating point 
values (12 bytes each) from the list of floating 
point expressions. Only simple floating point 
constants are allowed for fexpr. 



Pseudo-Ops 6-5 



Table 6-2. Data Initialization Pseudo-Ops (continued) 



Pseudo-Op 


Description 


space abs 

Icomm id, size, align 


When used within the data or text segment, this 
pseudo-op generates abs bytes of zeroes in the 
assembly output, where abs is a pass-one absolute 
integer expression > 0. 

When used in the bss segment, it allocates abs 
number of bytes for uninitiaUzed data. This data 
space is not actually allocated until the program is 
loaded. 

Allocate size bytes within bss, after aligning to 
align within the bss assembly segment. Both size 
and align must be absolute integer values 
computable on the first pass. Size must be > 0; 
align must be > 0. 

Icomm always allocates space within bss, regardless 
of the current assembly segment; however, it does 
not change the current assembly segment. 
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Symbol Definition Pseudo-Ops 

Symbol definition pseudo-ops allow you to assign values to symbols 
(identifiers), define common areas, and specify symbols as global. Table 6-3 
describes the symbol definition pseudo-ops. 

Table 6-3. Symbol Definition Pseudo-Ops 



Pseudo-Op 


Description 


set id,iexpr 

coma. id,abs 
global id[,id] 


Sets the value of the identifier id to iexpr which 
may be pass-one integer absolute or pass-one 
relocatable. A pass-one relocatable expression is 
defined as: 

sym ± abs 

where sym has been defined prior to encountering 
the expression in pass one, and abs is pass-one 
absolute. 

Allocates a common area named id of size abs 
bytes. The abs parameter must be pass-one 
absolute. The linker will allocate space for it. The 
symbol id is marked as global. 

Declares the list of identifiers to be global symbols. 
The names will be placed in the linker symbol 
table and will be available to separately assembled 
.0 files. This allows the linker (see ld(l)) to 
resolve references to id in other programs. 
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Alignment Pseudo-Ops 

Alignment pseudo-ops allow the programmer to force the location counter to a 
particular memory boundary. Table 6-4 defines the two alignment pseudo-ops 
provided by as. 

Table 6-4. Alignment Pseudo-Ops 



Pseudo-Op 


Description 


lalign abs 

even 

align name, abs 


Align modulo abs in the current segment, abs 
must be a pass-one absolute integer expression. 
The most useful forms are: 

lalign 2 
lalign 4 

within the data or bss segments. These force 
16-bit (word) and 32-bit alignment, respectively, in 
the current segment. When used in the data or 
text segment, the "filler" bytes generated by the 
ahgnment are initiahzed to zeroes. If the 
statement is labeled, the label's value is assigned 
before the "filler" bytes are added. (See "A Note 
about lalign" below for details on how this 
pseudo-op is used.) 

Same as lalign 2. 

This pseudo-op creates a global symbol of type 
align. When the linker sees this symbol, it will 
create a hole beginning at symbol name whose size 
will be such that the next symbol will be ahgned 
on a abs modulo boundary, abs must be a 
pass-one absolute integer expression. (See "A Note 
about lalign" below for details on this pseudo-op.) 
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A Note about lalign 

The assembler concatenates text, data, and bss segments when forming its 
output (object) file. The assembler rounds each segment size up to the next 
multiple of four bytes, which may or may not leave unused space at the end of 
each segment. 

When multiple object ( . o) files are linked, Id concatenates all text segments 
into one contiguous text segment, all data segments into one contiguous data 
segment, and all bss segments into one contiguous bss segment. Because of 
this, only lalign values of 1, 2, and 4 can be guaranteed to be preserved; any 
other lalign values cannot be guaranteed. This also applies to the Icomm 
pseudo-op. 

A Note about align 

The align pseudo-op should be used with care. Consider the following 
example: 

bss 

align gap , 1024 
Table : space 4096 

The align pseudo-op causes Table to be aligned on a 1Kb boundary in 
memory. The symbol gap is the address of the hole created before the start of 
Table. Because the actual afignment of gap is performed by the linker and not 
the assembler (the assembler assigns addresses as though the hole size were 
zero), any expression calculation which spans the alignment hole will yield 
incorrect results. For example: 





bss 




x: 


space 


10 




align 


gap, 1024 


Table: 


space 


4096 


Table. end: 


space 
data 





bss.size: 


Table. 


.end - X # ' 



# The assembler asstimes the size of 

# "gap" to be zero, so this 

# expression yields incorrect results. 
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Pseudo-Ops to Control Expression Calculation 
with Span-Dependent Optimization 

Table 6-5 describes pseudo-ops provided to control pass one symbol subtraction 
calculations when the -0 (span-dependent optimization) option is used. These 
pseudo-ops have no effect and are ignored if the -0 option is not in effect. 

Table 6-5. Symbol Subtraction 



Pseudo-Op 


Description 


allow_plsub 
end.plsub 


Directs the assembler to perform symbol 
subtractions in pass one when both symbols are 
known, even if the symbols are text symbols. Two 
text symbols in a difference (identif ierl - 
identif ier2) should not be separated by any 
code that could be modified by span-dependent 
optimization. 

Directs the assembler to revert to the default for 
subtractions when the -0 option is used; 
subtractions involving text symbols will be delayed 
until pass two. 



When the -0 option is used, all subtraction calculations of text symbols are 
normally delayed until pass two since the final segment relative offset of a text 
symbol cannot be determined in pass one. This limits expressions involving 
the subtraction of text symbols to identifier - identifier. The allow_plsub 
and end_plsub pseudo-ops bracket areas where the assembler is directed to 
calculate text symbol subtractions in pass one provided the symbols are already 
defined. Two text symbols in a difference (label 1 - label2) should not be 
separated by any code that could be modified by span-dependent optimization 
since the subtraction is calculated using pass one offsets. 
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Floating-Point Pseudo-Ops 

Table 6-6 describes the floating-point pseudo-ops. 

Table 6-6. Floating-Point Pseudo-Ops 



Pseudo-Op 


Description 


f pmode abs 

fpid abs 
fpareg '/.an 


Sets the floating point mode for the conversion of 
floating point constants used with the float, 
double, extend, and packed pseudo-ops or as 
immediate operands to MC68881/2 or FPA 
instructions. Vahd modes are defined by cvtnuni 
(see cvtnuTn{SC) for details on modes). By default, 
the f pmode is initially (C_NEAR). 

VaUd values for f pmode, as defined in cvtnum{ZC) 
are: 

(C.NEAR) 

1 (C_POS_INF) 

2 (C_NEG_INF) 

3 (C.TOZERO) 

Sets the co-processor id-number for the MC6888 1 
floating point processor. By default, the id-number 
is initially 1. 

Sets the FPA base register to be used in 
translating FPA pseudo instructions to 
memory-mapped move instructions. By default, 
register V,a.2 is used. Note that this does not 
generate code to load the FPA base address into 
•/,a2. The user must explicitly load the register (see 
HP 98248A Floating-Point Accelerator Reference) . 
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Version Pseudo-Ops 

Table 7-7 describes the version pseudo-op. Beginning with the HP-UX 6.5 
release, the assembler supports a version pseudo-op for setting the a.stamp 
field in the a. out header (see a.out(4)). Prior to release 6.5, this field was 
always set to by the assembler. 

Table 6-7. Table 7-7. Version Pseudo-Ops 



Pseudo-Op 


Description 


version abs 


where abs must be a pass-one absolute integer 
expression. Multiple version pseudo-op's will 
generate a warning from the assembler and the last 
occurrence will be used. 

The -V number command line option can also be 
used to set the a_ stamp field. If the -V command 
line option is used, that overrides any version 
pseudo-op in the source file. 



The 68020/30/40 HP-UX compilers save and restore the non-scratch floating 
point registers that they use (*/,fp2 through */,fp7 and 7,fpa3 through y.fpalS), 
and will assume that called functions will do the same. The 68010 compilers do 
not allocate floating point registers (there is no 68881 on the Model 310). This 
incompatibiUty with the pre-6.5 compiler conventions can cause a problem if 
new code allocates a floating point register and calls old code which uses that 
register as a scratch register. 

The 6.5 compilers use the a.stamp field to mark the type of code being 
generated so that the linker can give warning messages about possible 
incompatibilities with pre-6.5 object files. The a.stamp field is set by the 
compilers according to the following conventions: 

pre-6.5 or unknown 6.5 floating point usage 

1 68010 code 

2 code which does not depend on new save/restore assumptions 

3 68020 code which depends on called-routine save/restore of floating 
point registers 
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You should set an appropriate version value using either the version 
pseudo-op or the -V option. 

The linker issues a warning if an attempt is made to link a combination of 
version with any new version code. The linker warning is: 

(weurning) - old (pre-6.5) file filename may be incompatible with newer files 

The assembler issues a warning if no version is set and floating point opcodes 
are used. The assembler warning is: 

as: warning: "x.s" line 2: no version specified and floating point ops 

present; version may not be properly set (set Assembler Reference Manual) 

Set the a_stamp field using version to an appropriate value (using version or 
-V) to eliminate these warnings. 

If you use permanent floating point registers but do not call any routines that 
could corrupt those registers, you can safely include a version 2 directive to 
avoid any warning messages when linking. 

If no version pseudo-op or -V option is specified, the assembler sets the 
a_ stamp field according to the following rules: 

as20 invoked, floating point operations are present, and a warning 
message is generated 

1 as 10 invoked 

2 as20 invoked and no floating point operations are present 
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Shared Library Pseudo Ops 

Table 6-8 shows pseudo-ops that can be used when creating position- 
independent code (PIC) for shared libraries (i.e., when as is invoked with the 
+z or +Z option). 

Table 6-8. Shared Library Pseudo-Ops 



Pseudo-Op 


Description 


shlib_ vers ion 
internal 


Sets the shared library version date. (See Programming 
on HP- UX for details on shared library version 
control.) 

Keeps internal labels from breaking up data structures 
when placed in memory at run-time. (See 
Programming on HP- UX for details on internal labels.) 



Symbolic Debug Support Pseudo-Ops 

The as assembler also supports pseudo-ops for use by the C debugger (see 
xdb{l)). These are not of much use to as programmers and are shown here 
merely for completeness: 

gntt 

Intt 

sit 

vt 

xt 
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Address Mode Syntax 



Table 7-1 summarizes the as syntax for MC680a;0 addressing modes. The 
following conventions are used in Table 7-1: 

•/,an Address register n, where n is any digit from through 7. 

*/,dn Data register n, where n is any digit from through 7. 

%ri Index register n may be any address or data register with an optional 
size designation (i.e., n.w for 16 bits or ri .1 for 32 bits); default size is 
.w. 

scl Optional scale factor. An index register may be multiplied by the scaling 
factor in some addressing modes. Values for scl are 1, 2, 4, or 8; default 
is 1. For the MC68010, only the default scale factor 1 is allowed. 

6c? Two's complement base displacement added before indirection takes 
place; its size can be 16 or 32 bits. (MC68020/30/40 only.) 

od Two's-complement outer displacement added as part of effective address 
calculation after memory indirection; its size can be 16 or 32 bits. 
(MC68020/30/40 only.) 

d Two's complement (sign-extended) displacement added as part of the 
effective address calculation; its size may be 8 or 16 bits; when omitted, 
the assembler uses a value of zero. 

*/,pc Program counter, 

C ] Square brackets are used to enclose an indirect expression; these 
characters are required where shown. (MC68020/30/40 only.) 

( ) Parentheses are used to enclose an entire effective address; these 
characters are required where shown. 

{} Braces {} indicate that a scaling factor {*scl) is optional; these characters 
should not appear where shown. 
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Table 7-1. Effective Address Modes 






MC680rO 
Family Notation 


as 
Notation 


Effective 

Address 

Mode 


Register 

Encoding 

>68020 


Register 

Encoding 

<68010 


Dn 


'/,dn 


Data register direct 


000/n 


000/n 


An 


7.an 


Address register direct 


001 /n 


001 /n 


(An) 


(7.an) 


Address register 
indirect 


010/n 


010/n 


(An)+ 


CUn) + 


Address register 
indirect with 
post-increment 


011/n 


011/n 


-(An) 


-C/.an) 


Address register 
indirect with 
pre-decrement 


100/n 


100/n 


d(An)i 


dV/.a.n') 


Address register 
indirect or (.d,y,a.n) 
with displacement 


101/n^ 
110/n 
full fmt 


101/n 


d(An,Ri)2 


^(y,a7i,y,n) 


Address register 

indirect or 

id ,%a.n yXri} with 

index plus 

displacement 


llO/n^ 

brief fmt 
llO/n 

full fmt 


110/n 


(bd,An,Ri{*scl}) 
MC68020/30/40 only 


Ud ,'Un ,y,ri{*scl}) 


Address register direct 
with index plus base 
displacement 


llO/n 
full fmt 


— 


([bd,An,Ri{*scl}],od) 
MC68020/30/40 only 


( Lbd ,7,an ,*/,n{*sc/}] , od") 


Memory indirect with 
pre-indexing plus base 
and outer displacement 


110/n 
full fmt 


— 


([bd,An],Ri{*scl},od) 
MC68020/30/40 only 


abd,'Unl ,'/,ri{*scl},od) 


Memory indirect with 
post-indexing plus 
base and outer 
displacement 


110/n 
full fmt 
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Table 7-1. Effective Address Modes (continued) 



MC680arO 
Family Notation 


as 
Notation 


Effective 

Address 

Mode 


Register 

Encoding 

>68020 


Register 

Encoding 

<68010 


d(PC) 


i<7.pc) 


Program coimter 
indirect or (<Z,y.pc) 
with displacement 


111/010^ 
111/011 
full fmt 


111/010 


d(PC,Ri) 


^(y.pc,y.n.i) 


Program covinter 
direct or (<i,7,pc,y.n') 
with index and 
displacement 


111/011* 
brief fmt 

111/011 
full fmt 


111/011 


(bd,PC,Ri{*scl})^ 
MC68020/30/40 only 


<.bdj,-pc,'/.ri{*scl}) 


Program coimter 
direct with index and 
base displacement 


111/011 
full fmt 


— 


([bd,PC],Ri{*scl},od)5 
MC68020/30/40 only 


abd,y,-pci,y.ri{*sci},od) 


Program cotmter 
memory indirect with 
post-indexing plus 
base ajid outer 
displacement 


111/011 
full fmt 




([bd,PC,Ri{*scl}],od)5 
MC68020/30/40 only 


abd,'/,-pc,%ri{*scl}2,od'> 


Program counter 
memory indirect with 
pre-indexing plus base 
and outer displacement 


111/011 
full fmt 




xxx.W 


XXX or XXX. ■a^ 


Absolute short address 
(xxx signifies an 
expression yielding a 
16-bit memory 
address) 


111/000 


111/000 


XXX. L 


XXX or XXX .1.^ 


Absolute long address 
{xxx signifies an 
expression yielding a 
32-bit memory 
address) 


111/001 


111/001 


#xxx 


txxx 


Immediate operand or 
immediate data {xxx 
signifies a constant 
expression); for 
example, ft0f3.14 is an 
immediate operand. 


111/100 


111/100 
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The following notes apply to Table 7-1. 

1. li d is pass-one, 16- bit absolute and the base register (*/,an or Xpc is not 
suppressed), then the MC68010-compatible mode is chosen; otherwise, the 
more general MC68020/30/40 full form is assumed. 

2. If d is not pass-one 8-bit absolute, or the base register ('/.an or */,pc) is 
suppressed, the more general MC68020/30/40 full-format form is assumed. 

3. If d is pass-one, 16-bit absolute and the base register ('/.an or y.pc is not 
suppressed), then the MC68010-compatible mode is chosen; otherwise, the 
more general MC68020/30/40 full form is assumed. 

4. If d is not pass-one 8-bit absolute, or the base register (*/,an or */,pc) is 
suppressed, the more general MC68020/30/40 full-format form is assumed. 

5. The size of the bd and od displacement fields is 16 bits if the displacement 
is pass-one 16-bit absolute; otherwise, a 32-bit displacement is used. (For 
details, see the section below entitled "MC68020/30/40 Addressing Mode 
Optimization.") 

6. If no size suffix is specified for an absolute address, the assembler will use 
absolute- word if xxx is pass-one absolute and fits in 16 bits; otherwise, 
absolute-long is chosen. 



Notes on Addressing Modes 

The components of each addressing syntax must appear in the order shown in 
Table 7-1. 

It is important to note that expressions used for absolute addressing modes 
need not be absolute expressions, as described in the "Expressions" chapter. 
Although the addresses used in those addressing modes must ultimately be 
fiUed-in with constants, that can be done later by the linker. There is no 
need for the assembler to be able to compute them. Indeed, the absolute long 
addressing mode is commonly used for accessing undefined external addresses. 

Address components which are expressions {\bd, od, d, absolute, and 
immediate) can, in general, be absolute, relocatable, or external expressions. 
Relocatable or external expressions generate relocation information with the 
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final value set by the linker. It should be noted that relocation of byte- or 
word-sized expressions will result in truncation. The base displacement {bd 
or d) of a PC-relative addressing mode can be an absolute or relocatable 
expression, but not an external expression. 

In Table 7-1, the index register notation should be understood as ri .size* scale, 
where both size and scale are optional. For the MC68010 processor, only the 
default scale factor *1 is allowed. 

Refer to the appropriate MC680xO microprocessor user's manual for additional 
information about effective address modes. 

Note that suppressed address register */,zan can be used in place of address 
register '/.an; suppressed PC register */,zpc can be used in place of '/,pc; and 
suppressed data register */»zdn can be used in place of '/,dn, if suppression is 
desired. (This applies to MC68020/30/40 full-format forms only.) 

Note also that an expression used as an address always generates an absolute 
addressing mode, even if the expression represents a location in the current 
assembly segment. If the expression represents a location in the current 
assembly segment and PC-relative addressing is desired, this must be explicitly 
specified as xxxC/*j>c). 

The new address modes for the MC68020/30/40 use two different formats of 
extension. The brief format provides fast indexed addressing, while the full 
format provides a number of options in size of displacement and indirection. 
The assembler will generate the brief format if the following conditions are met: 

■ The effective address expression is not memory indirect. 

■ The value of displacement is within a byte and this can be determined at 
pass one. 

■ No base or index suppression is specified. 

Otherwise, the assembler will generate the full format. 

In the MC68020/30/40 full-format addressing syntaxes, aU the address 
components are optional, except that "empty" syntaxes, such as () or ([] ,10), 
are not legal. Omitted displacements are assumed to be 0; an omitted base 
register defaults to */,zaO; an omitted index register defaults to '/.zdO. To specify 
a PC-relative addressing mode with the base register ('/.pc) suppressed, */.zpc 
must be explicitly specified since an omitted base register defaults to '/.zaO. 
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Some source code variations of the new modes may be redundant with the 
MC68000 address register indirect, address register indirect with displacement, 
and program counter with displacement modes. The assembler will select the 
more efficient mode when redundancy occurs. For example, when the assembler 
sees the form C/.an), it will generate address register indirect mode (mode 2). 
The assembler will generate address register indirect with displacement (mode 
5) when seeing either of the following forms (as long as bd is pass-1 absolute 
and will fit in 16 bits or less): 

■ 6c?(*/.an) 

■ (6c?, y.an) 

For the PC-addressing modes 

m 6o?(y.pc) 

■ 6c?(y,pc, y,n) 

■ ([6c?, y,pc] , y.n, od) 

■ ([6c?, y,pc, y,n] , od) 

bd can either be relocatable in the current segment or absolute. If 6c? is 
absolute, it is taken to be the displacement value; the value is never adjusted 
by the assembler. If 6c? is relocatable and in the current segment, it is taken to 
be a target; the assembler calculates the appropriate displacement. 6c? cannot 
be an external symbol or a relocatable symbol in a different segment. 



MC68020/30/40 Addressing Mode Optimization 

There are several addressing mode syntaxes that could produce either 8-, 
16-, or 32- bit offsets. The as assembler attempts to select the smallest 
displacement, based on the information it has available at pass one when an 
instruction is assembled. 

Examples 

The addressing mode syntax 
(6c?, y.an, y,rO 
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will be translated to the most efficient form possible (i.e., the shortest form of 
the instruction possible), based on the information the assembler has available 
at pass one — when the assembler first encounters it. 

If bd is pass-one absolute and fits in 8 bits (—127. .128), and neither the base 
(Xarz) nor index (*/,n) register is suppressed, then the MC68020/30/40 brief 
format "address register indirect with index and 8-bit displacement" mode 
is chosen. (Note that if the scale factor is the default (*l), then this is a 
MC68010-compatible addressing mode.) 

Otherwise, the MC68020/30/40 full format "address register indirect with 
index and base displacement" mode is used. The size of the Base Displacement 
(16- or 32- bit) is based on whether 6c? is pass-one absolute and fits in 16 bits. 
The following examples should help clarify: 

# 

# Example One: 

# 

set offset, 10 

tst.w (offset,y,a6,y.d2) # Brief format with 8-bit 

# displacement is chosen. 

In the above example, brief format with 8-bit displacement was chosen by the 
assembler because the value of the base displacement (in this case, offset) was 
known prior to the tst.w instruction (it was pass-one absolute) and neither 
y,a6 nor %d2 is a suppressed register. 



# Example Two: 
# 

tst.w (offset,y.a6,7.d2) # Full format is used and 32 bits 

# are reserved for the offset. 

set offset, 10 

In this example, full format is used for the instruction and a 32- bit 
displacement is generated, even though only 8 bits are required for the base 
displacement (offset). This is because the assembler does not know the value 
of offset before encountering the tst.w instruction; therefore, it cannot 
assume that the base displacement will fit in 8 bits. 

Similarly, the addressing mode syntax 
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(bd, y.an) 

is converted to "address register indirect with 16-bit displacement" (Mode 5) 
if the base displacement [bd) is pass-one absolute and fits in 16 bits, and if 
y,a72 is not a suppressed register. Otherwise, the assembler uses a 32-bit base 
displacement with the equivalent form 

(bd, y.an, y.zdO) 
A similar situation holds for the displacements in PC addressing modes. 

Forcing Small Displacements (-d) 

Invoking as with the -d option forces the assembler to use the shortest form 
and smallest base displacement possible for all MC680 10-compatible addressing 
modes. 

For example, the addressing mode syntax 

(bd, y,an, %ri) 
always assumes an 8-bit displacement. And, 

(bd, y.an) 

always assumes a 16- bit displacement. In both cases the registers cannot be 
suppressed, and the only index scale allowed is the default *1. 

Refer to Appendix A for details on using this option. 
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Instruction Sets 



This chapter describes the instructions available for the MC680xO processors, 
the MC6888a; and MC68040 floating-point coprocessors, and the HP 98248 
floating-point accelerator. 



MC680xO Instruction Sets 

Table 8-1 shows how MC680arO instructions should be written if they are to be 
interpreted correctly by the as assembler. For details on each instruction, see 
the appropriate processor manual. For details on the various address mode 
syntaxes used, see Chapter 7. 

The entire instruction set can be used on the MC68020/30/40. Instructions 
that are specific to a particular processor are noted appropriately in the 
"Operation" column of Table 8-1. (For further details on portability, see 
Appendix A.) 
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The following abbreviations are used in Table 8-1: 

5 The letter 5, as in add. 5, stands for one of the operation size 

attribute letters: b (byte), w (16-bit word), or 1 (32-bit word). 

A The letter A, as in add.^, stands for one of the address 

operation size attribute letters: w (16-bit word), or 1 (32-bit 
word). 

CC In the instructions bCC, db CC, sCC, tCC and tpCC, the 

letters CC represent any of the following condition code 
designations (except that the f and t conditions may not be 
used in the hCC instruction): 



CC 


carry clear 


lo 


low (=cs) 


cs 


carry set 


Is 


low or same 


eq 


equal 


It 


less than 


i 


false 


mi 


minus 


ge 


greater or equal 


ne 


not equal 


gt 


greater than 


Pl 


plus 


hi 


high 


t 


true 


hs 


high or same (=cc) 


vc 


overflow clear 


le 


less or equal 


vs 


overflow set 



EA This represents an arbitrary eflfective address. You should 

consult the appropriate reference manual for details on the 
addressing modes permitted for a given instruction. 

/ An expression used as an immediate operand. Immediate 

expressions have the syntax &xxx, where xxx is a constant 
expressions. For example, &42 is an immediate operand with 
value 42. 

Q A pass-one absolute expression evaluating to a number from 1 

to 8. 

L A label reference, or any expression, representing a memory 

address in the current segment. 

d Two's complement or sign-extended displacement added as 

part of eff'ective address calculation; size may be 8 or 16 bits; 
when omitted, the assembler uses a value of zero. 
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y.da;, y.di/, '/.dn Data registers. 

'/♦ax, y,ay, Xan Address registers. 

*hrx^ *Lry^ *Lrn Represent either data or address registers. 

%rc Represents a control register (y.sf c, y.df c, y,cacr, Xusp, y.vbr, 

y.caar, yjasp, y.isp). 

reglist Specifies a set of registers for the movm instruction. A reglist 

is a set of register identifiers separated by slashes. Ranges of 
registers can be specified as y,am-y,an and/or y,dm-y,dn (where 
m < n). For example, the following are valid reglists: 

y.do/y.d3 

y.al/y.a2/y.d3-y.d6 

{} braces represent an optional portion of an instruction; they 

should not appear where shown. 

offset Either an immediate operand or a data register. An immediate 

operand must be pass-one absolute. 

width Either an immediate operand or a data register. An immediate 

operand must be pass-one absolute. 

When / represents a standard immediate mode effective address (i.e., 
MC68020/30/40 Mode 7, Register 4), as for the addi instruction, the 
expression can be absolute, relocatable, or external. However, when / 
represents a special immediate operand that is a field in the instruction word 
(e.g., for the bkpt instruction), then the expression must be pass-one absolute. 
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Table 8-1. MC680xO instruction Formats 



MC680a:0 

Family 
Mneiuonic 


as 
Assembler Syntax 


Operation 


Default Size 


ABCD 


abcd.b%d2/,y,dz 
abcd.b-(y.a2/),-C/.ax) 


Add Decimal with Extend 


.b 


ADD 


add.5 EA/Adn 
aidd.SV,dn,EA 


Add Binary 


• W 


ADDA 


aidd.A EAX^n 
adda.^ £'A,'/.an 


Add Address 


.w 


ADDI 


add.5 kl.EA 
^dd\.S kl ,EA 


Add Immediate 


.w 


ADDQ 


add.5 icQ,EA 
Siddq.S &Q,EA 


Add Quick 


• W 


ADDX 


a.ddx.S %dy //^x 
addx.5-(y.aj^),-(y.aa;) 


Add Extend 


.w 


AND 


and. 5 EA,%dn 
and.5 y.dn , EA 


AND Logical 


.w 


ANDI 


and. 5 &I,EA 
audi. S &I,E A 


AND Immediate 


.w 


ANDI to 
CCR 


and.b &/,y,cc 
andi.b &I ,*/,cc 


AND Immediate to 
Condition Codes 


.b 


ANDI to 
SR 


and.w Scl ,*Asr 
emdi . w &/ , y.sr 


AND Immediate to the 
Status Register 


.w 


ASL 


asl.5y.dx,y.dy 
&S1.S &Q,V,dy 

asl.w &/,^^ 
asl.w EA 


Arithmetic Shift Left 


.w 
.w 


ASR 


asr.5 y.dx,y.dj^ 
asr.5 &Q,%dy 

asr.w &I ,EA 
asr.w EA 


Arithmetic Shift Right 


.w 
.w 
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Table 8-1. MC680xO Instruction Formats (continued) 



MC680a:0 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


Bee 


bCC.wi 
bCC.b L 
bCC.l L 

hCC L 


Branch Conditionally 
(16-Bit Displacement) 

Branch Conditionally 
Short (8-Bit Displacement) 

Branch Conditionally 
Long(32-Bit Displacement) 
(MC68020/30/40 only) 

SameasbCC.w^ 


. w required 
. b required 
. 1 required 


BCHG 


bchg %dn , EA 
bchg &/ , EA 


Test a Bit and Change 


. 1 if 2"^ operand 
is data register, 
else .b 


BCLR 


bclr '/.dn , EA 
bclr &I , EA 


Test a Bit and Clear 


.1 if 2"^ op 
is data register, 
else .b 


BFCHG 


bfchg EA{offset : width} 


Complement Bit Field 
(MC68020/30/40 only) 


No sufRx allowed 


BFCLR 


bfclr ^A{o#5e^:w;i(fiA} 


Clear Bit Field 
(MC68020/30/40 only) 


No suffix allowed 


BFEXTS 


bf exts EA 

{ oj^sei : width } ,VAn 


Extract Bit Field (Signed) 
(MC68020/30/40 only) 


No suffix allowed 


BFEXTU 


bf extu EA 

{ offset : width },V,dn 


Extract Bit Field 
(Unsigned) 
(MC68020/30/40 only) 


No suffix allowed 
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Table 8-1. MC680xO instruction Formats (continued) 



MC680a:0 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


BFFFO 


bfff o EA 

{ offset : width } , *Adn 


Find First One in Bit Field 
(MC68020/30/40 only) 


No suffix allowed 


BFINS 


bfins V,dn,EA 
{ offset : width } 


Insert Bit Field 
(MC68020/30/40 only) 


No suffix allowed 


BFSET 


bf set EA{offset : width} 


Set Bit Field 
(MC68020/30/40 only) 


No suffix allowed 


BFTST 


bf tst EA{offset : width] 


Test Bit Field 
(MC68020/30/40 only) 


No suffix allowed 


BKPT 


bkpt &P 


Breakpoint 
(MC68020/30/40 only) 


No suffix allowed 


BRA 


bra.w L 
hr.vL 

bra.b L 
br.b L 

bra.l L 
br.l L 

br L 


Branch Always (16-Bit 
Displacement) 

Branch Always (Short) 
(8-Bit Displacement) 

Branch Always (Long) 
(32-Bit Displacement) 
(MC68020/30/40 only) 

Defaults to br . w^ 


. w required 
.b required 
. 1 required 

.w 


BSET 


bset V,dn,EA 
bset &I ,EA 


Test a Bit and Set 


• lif 2"^ operand 
is data register, 
else .b 



8-6 Instruction Sets 



Table 8>1. MC680xO instruction Formats (continued) 



MC680rO 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


BSR 


bsr.¥ L 
bsr.b L 

bsr.l L 
bsr L 


Branch to Subroutine 
(16-bit Displacement) 

Branch to Subroutine 
(Short) (8-bit 
Displacement) 

Branch to Subroutine 
(Long) (32-bit Displace- 
ment)(MC68020/30/40 
only) 

Same as bsr . w^ 


. w required 
• b required 

.1 required 


BTST 


btst VAn , EA 
btst &/ , EA 


Test a Bit 


.lif 2"^ operand 
is data register, 
else .b 


CALLM 


callm &/ , EA 


Call Module 
(MC68020/30/40 only) 


No suffix allowed 


CAS 


caLS.Sy,dxMy,EA 


Compare and Swap 
Operands 
(MC68020/30/40 only) 


.¥ 


CAS2 


cas2.^ */,dx:*/Ay, 
*Adx:Uy,%rx:%ry 


Compare and Swap Dual 
Operands 
(MC68020/30/40 only) 


.w 



instruction Sets 8-7 



Table 8-1. MC680xO instruction Formats (continued) 



MC680rO 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


CHK 


chk.w EA,*/An 
chk.l EAMn 


Check Register Against 
Bounds 

Check Register Against 
Bounds (Long) 
(MC68020/30/40 only) 


.w 
.1 


CHK2 


chk2.5 EA,trn 


Check Register Against 
Bounds (MC68020/30/40 
only) 


.w 


CLR 


clr.5 EA 


Clear an Operand 


.w 


CMP 


cwp.SVAn.EA'^ 


Compare 


.w 


CMPA 


CBxp.A y.an.i;'^'* 
cmpa.A *Aa.n,EA'^ 


Compare Address 


.w 


CMPI 


crop. 5 EA,&I'^ 
cnipi.5 EA,&I'^ 


Compare Immediate 


.w 


CMPM 


cmp.5 (y.ax) + .(y.at/)+^ 
cnipm.5 (y,ax) + ,(y.a2/)+^ 


Compare Memory 


.w 


CMP2 


cmp2. S%rn,EA'^ 


Compare Register Against 
Bounds (MC68020/30/40 
only) 


• W 


DBcc 


dhCC.v*Adn,L 
dbra.w *Adn,L 
dbr.wy.dn,Z 


Test Condition, 
Decrement, and Branch 

Decrement and Branch 
Always 

Same as dbra.w 


.w 
.w 
.w 
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Table 8-1. MC680xO Instruction Formats (continued) 



Mcesoxo 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


DIVS 


divs.w EA,*/t6.x 

tdivs.l EA,*/Ax 
divs.l EAMx 

tdivs.l ^^,'/.dx:y.dj^ 
divsl.l EA,y,^x:VAy 

divs.l EA,VAx:%dy 


Signed Divide 32-bit -^ 
16-bit => 32-bit 

Signed Divide (Long) 
32-bit ^ 32-bit => 32-bit 
(MC68020/30/40 only) 

Signed Divide (Long) 
32-bit ^ 32-bit =» 32r:32q 
(MC68020/30/40 only) 

Signed Divide (Long) 
64-bit -^ 32-bit => 32r:32q 
(MC68020/30/40 only) 


.1 

. 1 required 

.1 
.1 


DIVU 


divu.w EAyVtdn 

tdivu.l EA,*/Ax 
divu.l EAMx 

tdivTi .1 EA, '/.dx : V,d.y 
divul.l EAMx'.VAy 

divu.l EAMx-.VAy 


Unsigned Divide 32-bit -^• 
16-bit =^ 32-bit 

Unsigned Divide (Long) 
32-bit H- 32-bit ^ 32-bit 
(MC68020/30/40 only) 

Unsigned Divide (Long) 
32-bit -ir 32-bit => 32r:32q 
(MC68020/30/40 only) 

Unsigned Divide (Long) , 
64-bit 4- 32-bit => 32r:32q 
(MC68020/30/40 only) 


.w 

.1 

. 1 required 

.1 
.1 


EOR 


Qor.SVAn.EA 


Exclusive OR Logical 


• W 


EORI 


eoT.S &I,EA 
eoxi. S &I,E A 


Exclusive OR Logical 


.w 


EORI to 
CCR 


eor.b &/,*/,cc 
eori.b &/,y,cc 


Exclusive OR Immediate 
to Condition Code Register 


.b 



Instruction Sets 8-9 



Table 8-1. MC680xO Instruction Formats (continued) 



MC680xO 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


EORI to 
SR 


eor.w &I ,V,ST 
eori.w &/,%sr 


Exclusive OR Immediate 
to Status Register 


.w 


EXG 


exg.l *Arx/Ary 


Exchange Registers 


.1 


EXT 


ext.w */,dn 


Sign-Extend Low-Order 
Byte of Data to Word 


• W 




ext . 1 */,dn 


Sign-Extend Low-Order 
Word of Data to Long 


.1 required 




extb.l y,dn 


Sign-Extend Low-Order 
Byte of Data to Long 
(MC68020/30/40 only) 


.1 




extw.l Vtdn 


Same as ext.l 
(MC68020/30/40 only) 


.1 


ILLEGAL 


illegal 


Take Illegal Instruction 
Trap 


No suffix allowed 


JMP 


jmp EA 


Jump 


No suffix allowed 


JSR 


jsr EA 


Jump to Subroutine 


No suffix allowed 


LEA 


lea.l EA/Aan 


Load Effective Address 


.1 


LINK 


link.w y.an.&Z 


Link and Allocate 


.w 




link.l */,an,&7 


Link and Allocate 
(MC68020/30/40 only) 


.1 required 
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Table 8-1. MC680xO Instruction Formats (continued) 



MC680rO 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


LSL 


Isl.SXdxMy 

Isl.S &Q,%dy 
Isl.w &I,EA 
Isl.w EA 


Logical Shift Left 


.w 


LSR 


lsT.Sy,dx,V,dy 
IsT.S &Q,%dy 
Isx. V &I,EA 
Isr.w EA 


Logical Shift Right 


.w 


M0VE16 


movie (•/,ax) + ,C/.a2/) + 
movie xxx.L,EA 
movie EA,xxx.L 


Move 16-Byte Block 
(MC68040 only) 


No suffix allowed 


MOVE 


mov.S EA,EA 


Move Data from Source to 
Destination 


.w 


MOV to 
CCR 


mov.w EAy*/,cc 


Move to Condition Codes 


.w 


MOVE 
from CCR 

MOVE to 
SR 


mov.w */»cc,EA 
mov.w EAyVtSx 


Move from Condition 
Codes 
(MC68010/20/30/40 only) 

Move to Status Register 


.w 
.w 


MOVE 
from SR 


mov.w VtZx^EA 


Move from Status Register 


.w 


MOVE 
USP 


mov.l y.Tisp.y.ara 
mov.l %an,%usp 


Move User Stack Pointer 


.1 


MOVEA 


mov.^l i^A.y.an 
mova.A EA,V»^.n 


Move Address 


.w 


MOVEC to 
CR 


mov.l *Arn,*/»rc 


Move to Control Register 
(MC68010/20/30/40 only) 


.1 
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Table 8-1. MC680xO Instruction Formats (continued) 



Mcesoro 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


MOVEC 
from CR 


mov.l %rc,%rn 


Move from Control 
Register 
(MC68010/20/30/40 only) 


.1 


MOVEM 


movm.yl &I yEA 
movm.^ EA,&I 


Move Multiple Registers 


.w 




movm.^l reglist,EA 
movm.yl EA,reglist 


Same as above, but using 
the reghst notation. 


,w 


MOVEP 


movp.AVAx,d ('/.a y ) 
movp.^ d(.*Aa.y) ,*Adx 


Move Peripheral Data 


.w 


MOVEQ 


mov . 1 &/ , y,dn 
movq.l &/,*/idn 


Move Quick 


.1 


MOVES 


mo vs. 5 V,rn,EA 
mo vs. 5 EA,*Arn 


Move to/from Address 
Space (MC68010/20/30/40 
only) 


.w 


MULS 


muls.w EA,*Adn 


Signed Multiply 16-bit x 
16-bit =^ 32-bit 


.w 




tmuls.l EA//,dn 
muls.l EA//,dn 


Signed Multiply (Long) 
32-bit X 32-bit => 32-bit 
(MC68020/30/40 only) 


.1 

.1 required 




muls.l EA,V,dx:%dy 


Signed Multiply (Long) 
32-bit X 32-bit => 64-bit 
(MC68020/30/40 only) 


.1 
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Table 8-1. MC680xO Instruction Formats (continued) 



MCeSOarO 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


MULU 


mulu.w EA,y,dn 

tmulu.l EA,*Adn 
mulu.l EA,'Ad.n 

mulu.l EA ,*/»dx :*Ady 


Unsigned Multiply 16-bit 
X 16-bit => 32-bit 

Unsigned Multiply (Long) 
32-bit X 32-bit => 32-bit 
(MC68020/30/40 only) 

Unsigned Multiply (Long) 
32-bit X 32-bit => 64-bit 
(MC68020/30/40 only) 


.1 

. 1 required 

.1 


NBCD 


nbcd.b EA 


Negate Decimal with 
Extend 


.b 


NEG 


neg.S EA 


Negate 


.w 


NEGX 


negx.5 EA 


Negate with Extend 


.w 


NOP 


nop 


No Operation 


No suffix allowed 


NOT 


not. 5 EA 


Logical Complement 


.w 


OR 


or. 5 EA,*/»dn 
oT.S%dn,EA 


Inclusive OR Logical 


.w 


ORI 


oz.S &I,EA 
oTi.S &I,EA 


Inclusive OR Immediate 


• W 


ORI 
toCCR 


or.b &/,y.cc 
ori.b &/,*/,cc 


Inclusive OR Immediate to 
Condition Codes 


.b 


ORI to SR 


or.w &! ,*/,sr 
ori . w & J , */,sr 


Inclusive OR Immediate to 
Status Register 


.w 
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Table 8-1. MC680xO Instruction Formats (continued) 



MC680xO 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


PACK 


pack -(%aa:),-C/.aj^),&/ 
packy.dx,y.dy,&/ 


Pack BCD 

(MC68020/30/40 only) 


No suffix allowed 


PEA 


pea.l EA 


Push Effective Address 


.1 


RESET 


reset 


Reset External Devices 


No suffix allowed 


ROL 


Tol.S%dx,%dy 
Tol.S &QjAy 
rol.v &I,EA 
rol.w EA 


Rotate (without Extend) 
Left 


.w 


ROR 


TOX.S %dx,%dy 
TOX.S &Q,V,dy 
xox.v&I,EA 
ror.w EA 


Rotate (without Extend) 
Right 


.w 


ROXL 


xoxl.S %dx ,Xdy 
xoxl. S &Q,yAy 
xoxl.v &I,E A 
roxl.w EA 


Rotate with Extend Left 


.w 


ROXR 


xoxT.SV,dx,VAy 
xoxx.S &Q ,*/,dy 
roxr.w &I ,EA 
roxr.w EA 


Rotate with Extend Right 


.w 


RTD 


rtd &/ 


Return and Deallocate 
Parameters 
(MC68010/20/30/40 only) 


No suffix allowed 


RTE 


rte 


Return from Exception 


No suffix allowed 
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Table 8-1. MC680xO Instruction Formats (continued) 



MC680xO 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


RTM 


rtm y.rn 


Return from Module 
(MC68020/30/40 only) 


No suffix allowed 


RTR 


rtr 


Return and Restore 
Condition Codes 


No suffix allowed 


RTS 


rts 


Return from Subroutine 


No suffix allowed 


SBCD 


sbcd.by,d2/,'/.dx 
sbcd.b -('/.a?/),-C/.ar) 


Subtract Decimal with 
Extend 


.b 


Sec 


sCC.h EA 


Set According to Condition 


.b 


STOP 


stop &/ 


Load Status Register and 
Stop 


No suffix allowed 


SUB 


sub. 5 EA,*/,d.n 
zyxb.S*/An,EA 


Subtract Binary 


.w 


SUBA 


sub. A EA,*/,3Ln 
suba.A jE'A/zian 


Subtract Address 


.w 


SUBI 




Subtract Immediate 


.w 


SUBQ 


svJd.S &Q,EA 
Bu^ac^.S iiQ,EA 


Subtract Quick 


,w 


SUBX 


subx.5y.dz/,y.dar 
subx.5-(y.aj/),-(y.ax) 


Subtract with Extend 


.w 


SWAP 


swap.w y,dn 


Swap Register Halves 


.w 
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Table 8-1. MC680xO Instruction Formats (continued) 



MC680a;0 

Family 
Mnemonic 


as 
Assembler Syntax 


Operation 


Default Size 


TAS 


tas.b EA 


Test and Set an Operand 


.b 


TRAP 


trap &/^ 


IVap 


No suffix allowed 


TRAPV 


trapv 


Trap on Overflow 


No suflax allowed 


TRAPcc 


tCC 
tpCC.A &/ 


Trap on Condition 
(MC68020/30/40 only) 


No suffix allowed 


TST 


tst.5 EA 


Test an Operand 


.w 


UNLK 


imlk y,an 


Unlink 


No suffix allowed 


UNPK 


unpk -('/.aj/) ,-(y,a?/) ,&/ 
unpky.dx,'/.dy,&/ 


Unpack BCD 
(MC68020/30/40 only) 


No suffix allowed 



1. Defaults to .w if -0 option not used. When -0 option is used, assembler sets 
the size based on the distance to the target L. 

2. The immediate operand must be a pass-one absolute expression. 

3. Defaults to .w when -0 is not used. When -0 option is used, the assembler 
sets the size based on the distance to the target L. 

4. The order of the operands for this instruction is reversed from that in the 
MC68000 Programmer's Reference Manual. 

5. The immediate operand must be a pass-one absolute expression. 
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MC6888X and MC68040 Floating-Point Instructions 

Table 8-4, found later in this section, shows how the floating-point coprocessor 
(MC6888a;) instructions should be written to be understood by the as 
assembler. These instructions are also available on the MC68040 processor, 
which has a math coprocessor built-in. In Table 8-4, FPCC represents any of 
the floating-point condition code designations shown in Table 8-2. 

Table 8-2. Floating-Point Condition Codes 



FPCC 


Meaning 


FPCC 


Meaning 




Ttap on Unordered 




No Trap on Ordered 


ge 


greater than or equal 


eq 


equal 


gl 


greater or less than 


oge 


greater than or equal 


gle 


greater or less than or equal 


ogl 


greater or less than 


gt 


greater than 


ogt 


greater than 


le 


less than or equal 


ole 


less than or equal 


It 


less than 


olt 


less than 


nge 


not greater than or equal 


or 


ordered 


nit 


not less than 


t 


always 


ngl 


not greater or less than 


ule 


unordered or less or equal 


nle 


not less than or equal to 


ult 


unordered less than 


ngle 


not greater or less than or equal 


uge 


unordered greater than or equal 


sneq 


not equal 


ueq 


unordered equal 


sne 


not equal 


ugt 


unordered greater than 


sf 


never 


Tin 


unordered 


seq 


equal 


neq 


unordered or greater or less 


St 


always 


ne 


unordered or greater or less 






f 


never 
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In Table 8-4, the designation ccc represents a group of constants in 
MC6888a;/MC68040 constant ROM. The values of these constants are 
defined in Table 8-3. (The description of the FMOVECR instruction in the 
MC68881/2 User's Manual provides detailed information on these constants.) 

Table 8-3. MC6888x/MC68040 Constant ROM Values 



Value 


CCC 


TT 


00 


logio(2) 


OB 


e 


oc 


log2(e) 


OD 


logio(e) 


OE 


0.0 


OF 


logn(2) 


30 


logn(lO) 


31 


10° 


32 


101 


33 


102 


34 


10^ 


35 


10=^ 


36 


lO^^ 


37 


1032 


38 


10«^ 


39 


10128 


3A 


10256 


3B 


10512 


3C 


101024 


3D 


102048 


3E 


104096 


3F 
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Other abbreviations used in Table 8-4 are: 
EA 



Represents an effective address. See the MC68881/2 User's 
Manual for details on the addressing modes permitted for 
each instruction. 

A label reference or any expression representing a memory 
address in the current segment. 

Represents an absolute expression used as an immediate 
operand. 



•/,dn Represents a data register. 

•/.fpm, y.fpn, y.fpg Represent floating-point data registers. 



fpreglist 

7.fpcr 
y.fpsr 
•/.fpiar 
fpcrlist 

&CCC 



A list of floating-point data registers for an f movm 
instruction. (See description of reglist in the description for 
Table 8-1.) 

Represents floating point control register. 

Represents floating point status register. 

Represents floating point instruction address register. 

A list of one to three floating point control register 
identifiers, separated by slashes (e.g., y,fpcr/*/,fpiar). 

An immediate operand for the fmover instruction. Must be 
pass-one absolute. 
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SF Represents source format letters; consult the MC68881 

User's Manual for restrictions on SF in combination with 
the EA (effective address) mode used: 

Letter Means 

b byte integer (8 bits) 

w word integer (16 bits) 

1 long word integer (32 bits) 

s single precision 

d double precision 

X extend precision 

p packed binary coded decimal 

A Represents source format letters w or 1 

Note When .SF is shown, a size suffix must be specified; there is no 

default size. In forms where .x is shown, size defaults to .x. 



An effective address for a packed-format operation has the form 

EA{kY} 
or 

EA{&dn] 
The first form requires A; to be a pass-one absolute value. 
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Table 8-4. 
MC6888X and MC68040 Floating-Point Instruction Formats 



Mnemonic 


Assembler Syntax 


Operation 


Default 
Operation Size 


FABS 


ta.hs.SF EA,y,fpn 
f abs . X '/,f pm , %ij>n 
fabs.x Vti-pn 


Absolute Value Function 


No default; give size 

.X 
.X 


FACOS 


tacos.SF EA,y,fpn 
f acos . X y^f pm , '/.f p n 
facos.x y.fpn 


Arcosine Function 


No default; give size 

.X 
.X 


FADD 


f add. SF EAJ,i]pn 
f add . X y.f p m , '/.f p n 


Floating Point Add 


No default; give size 
.w 


FASIN 


fasin.5i^ EA,y,fj>n 
fas in . X '/.f pm , */,f pn 
fasin.x '/.fpn 


Arcsine Function 


No default; give size 

.X 
.X 


FATAN 


ta.tsxi.SF EA,%iipn 
f at an . X '/,f p m , y.f p n 
fatan.x '/.fpn 


Arctangent Function 


No default; give size 

• X 
.X 


FATANH 


ta.t^vln.SF EA,%tvn 
f atanh . x '/.f pm ,y,fpn 
f ateinh . X y.f pn 


Hyperbolic Arctangent 
Function 


No default; give size 

.X 

,x 


FBfpcc 


thFPCC.A L 
thr.A L 
thra.A L 


Co-Processor Branch 
Conditionally Same as 
fbt. 




FCMP 


tcmip.SFlt-pn,EA^ 


Floating Point Compare 


No default; give size 
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Table 8-4. 
MC6888X and MC68040 Floating-Point Instruction Formats 

(continued) 



Mnemonic 


Assembler Syntax 


Operation 


Default 
Operation Size 


FCOS 


icos.SF EA,y,tpn 
f cos .X y.fpm ,*/,fpn 
fcos.x y.fpn 


Cosine Function 


No default; give size 

.X 
.X 


FCOSH 


i cosh. SF EA,'/dj>n 
f cosh . X */,f pm , y.f pn 
f cosh.x y.fpn 


Hyperbolic Cosine 
Function 


No default; give size 

.X 
• X 


FDBfpcc^ 


fdbFPCC.wy.dn,X 
fdbr.w L 
fdbra.w L 


Decrement and Branch 
on Condition Same as 
fdbf. 


.w 
.w 
.w 


FDIV 


idiv.SF i;^,y.fpn 
f div . X y.fpm , y.f p n 


Floating Point Divide 


No default; give size 

.X 


FETOX 


fetox. SF EA,%fpn 
f et ox . X y.f p m , y.f p n 
f etox.x %fpn 


e^ Function 


No default; give size 

.X 
.X 


FETOXMl 


f etoxml .SF EA //.f pn 
f etoxml . X y.fpm , y.fpn 
f etoxml. X y.fpn 


e^ — 1 Function 


No default; give size 

.X 
.X 


FGETEXP 


f get exp .SF EA, y.f p n 
f getexp . X y.fpm , y.fpn 
f get exp. X y.fpn 


Get the Exponent 
Function 


No default; give size 

.X 
.X 
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Table 8-4. 
MC6888X and MC68040 Floating-Point Instruction Formats 

(continued) 



Mnemonic 


Assembler Sjmtax 


Operation 


Default 
Operation Size 


FGETMAN 


f get man .SF EA, y.f p n 
f get man . x y.f p m , y.f p n 
fgetman.x y.fpn 


Get the Mantissa 
Function 


No default; give size 

.X 
.X 


FINT 


fint.5i^ EA,V,ipn 
f int . X y.f pm , y.fpn 
fint.x y.fpn 


Integer Part Function 


No default; give size 

.X 
.X 


FINTRZ 


fintrz.5F i^A, y.fpn 
f intrz . X y.f pm , y.f pn 
fintrz.x y.fpn 


Integer Part, Round to 
Zero Function 


No default; give size 

.X 
.X 


FL0G2 


flog2.5F i;^,y,fpn 
f log2 . X y.f pm , y.f p n 
flog2.x y.fpn 


Binary Log Function 


No default; give size 

• X 
.X 


FLOGIO 


flogl0.5i^ i;^,y.fpn 
flog 10.x y.f pm, y.fpn 
flogl0.xy.fpn 


Common Log Function 


No defualt, give size 

.X 
.X 


FLOGN 


flogn.5i^ i;^,y.fpn 
f logn . X y.f pm , y.f p n 
flogn.x y.fpn 


Natural Log Function 


No default; give size 

.X 
.X 


FLOGNPl 


flognpl.5i^i;^,y.fpn 
flognpl.x y.fpm, y.fpn 
flognpl.x y.fpn 


Natural Log (x+1) 
Function 


No default; give size 

.X 
.X 
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Table 8-4. 
MC6888X and MC68040 Floating-Point Instruction Formats 

(continued) 



Mnemonic 


Assembler Syntax 


Operation 


Defaidt 
Operation Size 


FMOD 


fmod.5i^ i:^,y.fpn 
f mod . X y.f pm , y.f p n 


Floating Point Modulus 


No default; give size 

.X 


FMOVE 


fmov.5F EA,%fpn 
fmov.x %fpm,%fpn 

fmov.5F y.fpn,i;^ 

f mov .p y.f pn , i;^{y.dn} 

fmov.py.fpn,i;^{&/}^ 

fmov.l £'^,y.fpcr^ 
fmov.l i;^,y.fpsr^ 
fmov.l i;^,y,fpiar^ 

fmov.l y.fpcr,jE;^5 
fmov.l y.fpsr,i;^^ 
fmov.l y.fpiar,i;^^ 


Move to Floating Point 
Register 

Move from Floating 
Point Register to 
Memory 

Move from Memory to 
Special Register 

Move from Special 
Register to Memory 


No default; give size 

.X 

No default; give size 

•P 

•P 

.1 
.1 
.1 

.1 
.1 
.1 


FMOVECR 


f mover .X &CCC, y.f pn'^ 


Move a ROM-Stored to 
a Floating Point 
Register 


.X 
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Table 8-4. 
MC6888X and MC88040 Floating-Point Instruction Formats 

(continued) 



Mnemonic 


Assembler Syntax 


Operation 


Default 
Operation Size 


FMOVEM 


fmovm.x EA,kI 


Move to Multiple 


.X 




f movm . X EA ,fpreglist 


Floating Point Registers 


.X 




fmovm.x EA//,dn 




.X 




f movm .x&I ,EA 


Move from Multiple to 


.X 




f movm . X fpreglist , EA 


MC68881 Control 


.X 




fmovm.x y,dn,EA 


Registers 


.X 




f movm . 1 EA Jpcrlist^ 


Move Multiple to 
MC6888 1 Control 
Registers 


.1 




f movm . 1 fpcrhst , EA^ 


Move from Multiple 
Registers Registers to 
Memory 


.1 


FMUL 


imal.SE EA/Afipn 


Floating Point Multiply 


No default; give size 




txaal . X y.f pm , y.f pn 




.X 


FNEG 


ineg.SF EA,*Afipn 


Negate Function 


No default; give size 




fneg.x y.fpm/Z.fpn 




.X 




fneg.x '/ifpn 




.X 


FNOP 


fnop 


Floating Point No- Op 


No sufl&x allowed 


FREM 


frem.SF i;A,y.fpn 


Floating Point 


No default; give size 




f rem . x y.f pm , y.f pn 


Remainder 


.X 
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Table 8-4. 
MC6888X and MC68040 Floating-Point Instruction Formats 

(continued) 



Mnemonic 


Assembler Syntax 


Operation 


Default 
Operation Size 


FRESTORI 


frestore EA 


Restore Internal State of 
Co-Processor 


No suffix allowed 


FSAVE 


f save EA 


Save Internal State of 
Co-Processor 


No suffix allowed 


FSCALE 


fscale.SF EA,%fpn 
f s cal e . X '/.f p m , '/.f p n 


Floating Point Scale 
Exponent 


No default; give size 

• X 


FSfpcc 


fsFPCC.h EA 


Set on Condition 


• b 


FSGLDIV 


isgldiv. SF EA,V,tpn 
i sgldi V . X y.f p m , %f p n 


Floating-Point 
Single-Precision Divide 


No default; give size 

.X 


FSGLMUL 


fsglmul.5F EA,V,fpn 
i sglmul . X '/.f p m , '/.f p n 


Floating-Point 

Single-Precision 

Multiply 


No default; give size 

.X 


FSIN 


isixL.SF EA,V»fj>n 
1 s in . X */,f pm , '/.f p n 
fsin.x y.fpn 


Sine Function 


No default; give size 

.X 
.X 


FSINCOS 


fsincos. 5i^ EA, 
•/.fpn:'/.fp? 
fsincos.x %fpm, 
%fipn:%fpq 


Sine/Cosine Function 


No default; give size 

.X 


FSINH 


isiT\h.SF EA,V»fpn 
fsinh.x %fpm,*/,fp7i 
f sinh.x y.fpn 


Hyperbolic Sine 
Function 


No default; give size 

.X 
.X 
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Table 8-4. 
MC6888X and MC68040 Floating-Point Instruction Formats 

(continued) 



Mnemonic 


Assembler Syntax 


Operation 


Default 
Operation Size 


FSQRT 


fsqrt. 5i^ EA,V,fj>n 
f sqrt .X y,f pm ,%fpra 
fsqrt.x y.fpn 


Square Root Function 


No default; give size 

.X 
.X 


FSUB 


isnh.SF EA,%fj>n 
f sub . X y.f p m , y.f p n 


Floating Point Subtract 


No default; give size 

.X 


FTAN 


itaxL.SF EA/Ai-pn 
f tan . X y.f pm , y.f pn 
ftan.x y.fpn 


Tangent Function 


No default; give size 

.X 
.X 


FTANH 


ita-nh.SF EA,%fTpn 
ftanh .X y.fpm ,y,fpn 
ftanh.x y.fpn 


Hyperbolic Tangent 
Function 


No default; give size 

.X 
.X 


FTENTOX 


ftentox.5i^ y.fpn 

ft ent ox . X y.f p m , y.f p n 

ftentox.x y.fpn 


10^ Function 


No default; give size 

.X 
.X 


FTfpcc 


ftFPCC 


Trap on Condition 
without a Parameter 


No suffix allowed 


FTPfpcc 


ftpFPCC.A &/ 


Trap on Condition with 
a Parameter 


.¥ 


FTEST 


ftest.5F EA 
ftest.x y.fpm 


Floating Point Test an 
Operand 


No default; give size 

.X 


FTWOTOX 


ftvotox.SF EA/Afpn 
f twotox . X y.f pm .y.fpn 
ftwotox.x y.fpn 


2^ Function 


No default; give size 

.X 
.X 
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The following notes apply to Table 8-4: 

1. Defaults to .w if -0 is not used. When -0 option is used, assembler sets the 
size based on the distance to the target L. 

2. The order of the operands for the FCMP instruction is reversed from that in 
the MC68881/2 Programmer's Reference Manual. 

3. The description of the FDBfpcc instruction found in the First Edition of 
the MC68881/2 User's Manual incorrectly states that "The value of the 
PC used in the branch address calculation is the address of the FDBcc 
instruction plus two." It should say "the address of the FDBcc instruction 
plus foury If you always reference this instruction using a label, then it 
should not cause any problems, as the assembler will automatically generate 
the correct offset. 

4. The immediate operand must be a pass-one absolute expression. 

5. See the MC68881/2 User's Manual for restrictions on EA (effective 
address) modes with this command. See the MC68881/2 User's Manual for 
restrictions on EA (effective address) modes with this command. 
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FPA Macros 



Table 8-5 shows how floating-point accelerator macros are written for use with 
the as assembler. These macros should only be used if you have the HP 98248 
floating-point accelerator. 

To help you interpret the "as Syntax" column of the following table, here is a 
list of notations used: 

y,f pa5' is the floating-point accelerator source. 

y.f paZ) is the floating-point accelerator destination. 

•/,f pacr is the floating-point accelerator control register. 

y.f pasr is the floating-point accelerator status register. 

{} 
EA 

L 

SF 



SB 



indicates that the text between these braces is optional. 

is the non-floating-point accelerator source. 

is a label. 

is a floating-point size suflftx that is required where shown: 

letter Means 

s single precision 



double precision 



is an MC68020/30/40 size sufiix for a branch instruction that 
is optional. If this suflfix is omitted and the -0 option for 
span-dependent optimization was not used, the default is .w. 
However, if the -0 option is used span-dependent optimization selects 
the size. 



Letter 

b 
w 
1 



Means 

byte integer (8 bits) 
word integer (16 bits) 
long word integer (32 bits) 
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Table 8-5. FPA-Macro Formats 



Mnemonic 


Assembler Syntax 


Operation 


FPABS 


f pabs . SF y.f pas 5{ , '/.f paX> } 


absolute value of operand 


FPADD 


f padd . SF '/.f pas S , '/.f paP 


addition 


FPAREG 


fpareg '/.an 


resets the address register to be 
used as the base register 


FPBEQ 


fpbeq.5B L 


branch if equal 


FPBF 


fTphf.SB L 


branch if false 


FPBGE 


ipbge.SB L 


branch if greater than or equal 


FPBGL 


fphgl. SB L 


branch if greater than or less than 


FPBGLE 


fpbgle.55 L 


branch if greater than, less than, or 
equal 


FPBGT 


fpbgt.55 L 


branch if greater than 


FPBLE 


iphle.SB L 


branch if less than or equal 


FPBLT 


iphlt.SB L 


branch if less than 


FPBNE 


fiphiLe.SB L 


branch if not equal 


FPBNGE 


fpbnge.55 L 


branch if not greater than or equal 


FPBNGL 


fpbngl.55 L 


branch if not greater than or less 
than 


FPBNGLE 


iphngle. SB L 


branch if not greater than, less 
than, or equal 


FPBNGT 


fpbngt.S'B L 


branch if not greater than 


FPBNLE 


fphnle.SB L 


branch if not less than or equal 


FPBNLT 


fpbnlt.55 L 


branch if not less than 
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Table 8-5. FPA-Macro Formats (continued) 



Mnemonic 


Assembler Syntax 


Operation 


FPBOGE 


fpboge.55 L 


branch if ordered greater than or 
equal 


FPBOGL 


fpbogl.55 L 


branch if ordered greater than or 
less than 


FPBOGT 


fpbogt.55 L 


branch if ordered greater than 


FPBOLE 


fpbole.55 L 


branch if ordered less than or equal 


FPBOLT 


fpbolt.55 L 


branch if ordered less than 


FPBOR 


fpbor.55 L 


branch if ordered 


FPBSEQ 


fpbseq.55 L 


branch if signalling equal 


FPBSF 


tpbsi.SB L 


branch if signalling false 


FPBSNE 


tpbsne.SB L 


branch if signalling not equal 


FPBST 


fpbst.55 L 


branch if signalling true 


FPBT 


tj>ht.SB L 


branch if true 


FPBUEQ 


fpbueq.55 L 


branch if unordered or equal 


FPBUGE 


fpbuge.55 L 


branch if unordered or greater than 
or equal 


FPBUGT 


fpbugt.55 L 


branch if unordered or greater than 


FPBULE 


tphvLle.SB L 


branch if unordered or less than or 
equal 


FPBULT 


fpbult.55 L 


branch if unordered or less than 


FPBUN 


fhjmxL.SB L 


branch if unordered 


FPCMP 


f pcmp . SF '/.f pa5 , '/.f paD 


compare 
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Table 8-5. FPA-Macro Formats (continued) 



Mnemonic 


Assembler Syntax 


Operation 


FPCVD 


f pcvd . 1 y.f pa5{ ,y.f paD} 


converts long word integer to 
double precision 


FPCVD 


f pcvd . s '/.f pa5 { , '/.f paZ> } 


converts single precision to double 
precision 


FPCVL 


f pcvl . d y,f pa5{ ,y,f paD} 


converts double precision to a long 
word integer 


FPCVL 


f pcvl . s y,f pa5{ , y.f paZ)} 


converts single precision to a long 
word integer 


FPCVS 


f pcvs . d y.f pa5{ , y.f paD} 


converts double precision to single 
precision 


FPCVS 


fpcvs.l y.fpa5{,y.fpai)} 


converts long word integer to single 
precision 


FPDIV 


f pdiv . SF y.f pa5 . y.f pal> 


division 


FPINTRZ 


f pintrz . SF y.f pa5 { , y.f paD } 


rounds to integer using the 
round-to-zero mode 


FPM2ADD 


f pm2add. SF EA , y.f pa5 , y.f paD 


combination move to destination 
and addition 


FPM2CMP 


fpm2cmp.5i^ ^^,y.fpa5,y.fpal> 


combination move to destination 
and compare 


FPM2DIV 


f pm2di V .SF EA, y.f pa5 , y.f pal> 


combination move to destination 
and division 


FPM2MUL 


f pm2mul .SF EA, y.f pa5 , y.f paD 


combination move to destination 
and multiplication 


FPM2RDIV 


f pni2rdiv .SF EA, y.f paS" , y.f pai) 


combination move to 
destinationand reverse division (i.e. 
source -=- destination) 
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Table 8-5. FPA-Macro Formats (continued) 



Mnemonic 


Assembler Syntax 


Operation 


FPM2RSUB 


f pin2r sub . SF EA ,'/.f pa5 , '/.f paD 


combination move to 
destinationand reverse subtraction 
(i.e. source — destination) 


FPM2SUB 


f pm2sub .SF EA, '/.f pa^ , '/.f paD 


combination move to destination 
and subtraction 


FPMABS 


f pmabs .SF EA, '/.f pa5{ , V.f pal> } 


combination move and taking 
absolute value of operand 


FPMADD 


f pmadd .SF EA, V.f pa5 , '/.f paZ) 


combination move and addition 


FPMCVD 


f pmcvd .1 EA, y.f pa5{ , '/.f paZ> } 


combination move and convert long 
word integer to double precision 


FPMCVD 


f pmc vd .s EA, V.f pa5 { , '/.f pal> } 


combination move and convert 
single precision to double precision 


FPMCVL 


f pmc vl .d EA, '/.f pa5 { . V.f paZ> } 


combination move and convert 
double precision to long word 
integer 


FPMCVL 


f pmcvl . s ^^ , '/.f pa5 { , y.f pai) } 


combination move and convert 
single precision to long word integer 


FPMCVS 


f pmcvs .d EA, V.f pa5 { , '/.f paZ) } 


combination move and convert 
double precision to single precision 


FPMCVS 


f pmcvs .1 EA, '/.f pa5{ , '/.IpaZ*} 


combination move and convert long 
word integer to single precision 


FPMDIV 


fpmdiv.5F i;A,*/.fpa5{,'/.fpaZ)} 


combination move and division 


FPMINTRZ 


fpmintrz.5jP 

i;^,y.fpa5{,y.fpai}} 


combination move and rounding 
tointeger using round-to-zero mode 


FPMMOV 


f pinmo V .SF EA, '/.f pa5 , '/.f paD 


combined move 
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Table 8-5. FPA-Macro Formats (continued) 



Mnemonic 


Assembler Syntax 


Operation 


FPMMUL 


f pmmul .SF EA, '/.f pa5 , */,f pal> 


combination move and 
multiplication 


FPMNEG 


fpmneg.S'J' EA /Atp&S { ,%fj>eiD} 


combination move and negation 


FPMOV 


tjpmov.SF EA,%fJp^iD 

fpmov. SF y.f pa5 , jE'yl move to an 
external location 

fpmov.5jP •/,fpa5,'/,fpal> move 
between two FPA registers 

fpmov.5i^ EA,y,iTp3iST move to 
the status register 

±-pmo-v. SF VtipsiST , EA move from 
the status register 

f-pmov. SF EA,*Ai-pa.cr move to 
the control register 

f-pmov. SF *AipaiCT,EA move from 
the control register 


move from an external location 
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Table 8-5. FPA-Macro Formats (continued) 



Mnemonic 


Assembler Syntax 


Operation 


FPMRDIV 


f pmrdiv .SF EA, '/.f pa5 , '/.f paP 


combination move and reverse 
division(i.e. source -i- destination) 


FPMRSUB 


fpiarsxLb.SF EA , y,lpa5 , '/.f paD 


combination move and 
reversesubtraction (i.e. source — 
destination) 


FPMSUB 


f pmsTib .SF EA, '/.f pa5 , '/.f pal> 


combination move and subtraction 


FPMTEST 


f pmt est. SF EA, '/.f pa5 


combination move and test of 
operand 


FPMUL 


f pmul . SF '/.f pa5 , '/.f paD 


multiplication 


FPNEG 


tpneg.SF y.fpa5{,%fpaP} 


negates the sign of an operand 


FPRDIV 


f prdi V . SF '/.f pa5 , '/.f paZ) 


reverse division (i.e. source -z- 
destination) 


FPRSUB 


f prsTib . SF '/.f pa5 , '/.f paD 


reverse subtraction(i.e. source — 
destination) 


FPSUB 


f psub . SF y.f pa5 , V.f paZ) 


subtraction 


FPTEST 


fptest.5i^y.fpa5 


compares the operand with zero 


FPWAIT 


fpwait 


generates a loop to wait for the 
completion of a previously executed 
instruction 
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9 



Assembler Listing Options 



As supports two options for generating assembling listings. The -A option 
causes a listing to be printed to stdout. The -a^'Hstfile option writes a listing 
to listfile. In general, listing lines have the form: 

lineno offset codebytes source 

The offset is in hexadecimal, and offsets for data and bss locations are adjusted 
to be relative to the beginning of text in the a. out file. The codebytes are 
listed in hexadecimal. A maximum of 24 code bytes are displayed per source 
line (8 bytes per listing line, up to 3 listing lines per source line); excess bytes 
are not listed. Implicit alignment bytes are not listed. The source field is 
truncated to 40 characters. 

The lister options cannot be used when the assembly source is stdin. 
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The following example shows a listing generating by assembling a small 
program using the -A option. 

1 0034 data 

2 0034 lalign 4 

3 0034 global _x 

4 0034 .x: 

5 0034 0000 0064 long 100 

6 0038 lalign 4 

7 0038 global _y 

8 0038 _y: 

9 0038 0000 0000 long 

10 0000 text 

11 0000 global .main 

12 0000 .main: 

13 0000 2F0E mov.l y.a6,-(y,sp) 

14 0002 2C4F mov.l y,sp,y,a6 

15 0004 DFFC FFFF FFF8 adda.l &LFl,y.sp 

16 OOOA 48D7 OOCO movm.l &LSl,(y,sp) 

17 OOOE 7C00 movq &0,y.d6 

18 0010 7E00 movq &0,y.d7 

19 0012 L16: 

20 0012 BEB9 0000 0034 cmp.l y,d7,_x 

21 0018 6C00 OOOA bge L15 

22 00 IC DC87 add.l y,d7,y.d6 

23 OOIE L14: 

24 OOIE 5287 addq.l &l,y,d7 

25 0020 6000 FFFO bra L16 

26 0024 L15: 

27 0024 23C6 0000 0038 mov.l y.d6,.y 

28 002A L13: 

29 002A 4CD7 OOCO movm.l (y,sp) ,&192 

30 002E 4E5E unlk y.a6 

31 0030 4E75 rts 

32 0032 set LFl,-8 

33 0032 set LSI, 192 

34 003C data 
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A 



Compatibility Issues 



When writing as assembly language code, you should be aware that each 
processor has a different register set. Because of this, it is possible to write 
assembly code that works on a Model 320 computer but doesn't work on a 
Model 310. Therefore, if your goal is to write portable code, keep the following 
in mind: 

■ Instructions that use the MC68020/30/40's additional registers will not work 
on either the MC68000 or MC68010. 

■ Likewise, instructions that use the MC68010's special registers will not 
work on the MC68000. However, such instructions will work on the 
MC68020/30/40 because the MC68010 register set is a subset of the 
MC68020/30/40 register set. 

■ The MC68010 instruction set is a subset of the MC68020/30/40 instruction 
set. Therefore, some MC68020/30/40 instructions will not work on the 
MC68010. 

■ The MC68881/2 processor is not supported on Model 310 computers. If you 
have a Model 310 computer, you cannot write assembly language code to use 
the MC68881. 

■ The MC68040 processor supports MC68881/2 floating-point instructions. 
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Using the -d Option 

The -d option to as is used under special circumstances. It is typically used 
when you wish to write code that meets the following conditions: 

■ The code is intended to run on any MC680a;0 processor. 

■ There are actually two versions of the code: one for the MC68010 processor; 
the other for the MC68020/30/40 and MC68881/2 processors. 

■ The program makes a run-time decision on which code to execute. 

For example, suppose you write some code to perform floating-point operations. 
You want the code to run on either a Model 310 or Model 320 computer. 
When the code runs on a Model 310, all floating-point operations must be 
performed in software; when the code runs on a Model 320, you want the code 
to use the MC68881 floating-point co-processor so that it will run faster. The 
following pseudo-code illustrates this concept: 



if this code runs on a computer with MC68020/30/40 and MC68881/2 then 

perform floating point operations using MC68881/2 
else /* code is running on a Model 310 computer */ 

perform floating point operations using library routines 
endif 

If you write code that meets these conditions, then you should use as with 
the -d option. The -d option ensures that only MC68010-compatible address 
displacements will be generated. Therefore, the MC68010 code generated by as 
will run on a Model 310. 



A-2 Compatibility Issues 



Determining Processor at Run Time 

The type of code discussed in the previous section is special in that it must 
determine which processor it is running on at run time. One way to make this 
run-time determination on current Series 300/400 computers is to look at the 
f lag_68010 flag in crtO.o. If this word is non-zero, then the processor is a 
MC68010; otherwise, it is a MC68020/30/40. 

Another method would be to write a routine that sets up signal-catching for 
the signal SIGILL. (The SIGILL interrupt is generated if an illegal instruction 
is executed.) Then the routine would execute an MC68020/30/40-only 
instruction. If the illegal instruction interrupt occurs, then the code is not 
running on an MC68020/30/40 processor. (See signal{2) for details on setting 
up a signal handler.) 

Two additional flag words are defined in crtO.o beginning with the 5.5 HP-UX 
release. These words are as follows: 

f lag_f pa is non-zero if there is a HP 98248 Floating-Point Accelerator in 

the system; otherwise, the word is zero (0). 

f lag_68881 is non-zero if there is an M68881 Floating-Point Coprocessor in 
the system; otherwise, the word is zero (0). 
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B 



B 



Diagnostics 



Whenever as detects a syntactic or semantic error, a single-line diagnostic 
message is written to standard error output (stderr). The message provides 
descriptive information along with the line number and filename in which the 
error occurred. 

Most of the error messages generated by as are descriptive and 
self-explanatory. Two general messages require further comment: 

■ "syntax error": as generates this message when a line's syntax is illegal. If 
you encounter this error, check the overall format of the line and the format 
of each operand. 

■ "syntax error (opcode/operand mismatch)": The overall syntax of the 
line is legal, and the format of each operand is also legal; however, the 
combination of opcode, operation size, and operand types is not legal. Check 
the addressing modes for each operand and the operation sizes that are legal 
for the given opcode. 
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Interfacing Assembly Routines 
to Other Languages 



This appendix describes information necessary to interface assembly language 
routines to procedures written in C, FORTRAN, or Pascal. 



Linking 

In order for a symbol defined in an assembly language source file (such as 
the name of an assembly language routine) to be known externally, it must 
be declared with the global pseudo-op. (The comm pseudo-op also marks 
identifiers as global. For details on these pseudo-ops, see Chapter 6.) 

It is not necessary for an externally defined symbol, used in an assembly 
program, to be declared in a global statement: if a symbol is used but not 
defined, it is assumed to be defined externally. However, to avoid possible 
name confusion with local symbols, it is recommended that you use the global 
pseudo-op to declare all external symbols. 
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Register Conventions 

Several registers are reserved for run- time stack use and other purposes. 

Frame and Stack Pointers 

Register A6 is designated as a pointer to the current stack frame; its value 
remains constant during the execution of a routine; all local variables are 
addressed from it. Register A7 is designated the run-time stack pointer. Its 
value changes during the execution of the routine. 

Scratch Registers 

Registers DO, Dl, AO, and Al are "scratch registers" which are reserved to 
contain intermediate results or temporary values which do not survive through 
a call to a function. That is, a called routine is free to alter these registers 
without saving and restoring previous values, and a calling routine must 
save the value (in memory or a non-scratch register) before making a call 
if it wants the value preserved. The C and FORTRAN compilers consider 
floating-point registers */,fpO and */,fpl to be scratch registers. Values for 
all other floating-point registers (y,fp2 through y.fp7) must be saved and 
restored by the called routine, and saved by the calling routine, to preserve the 
floating-point register value. Pascal preserves their values across procedure and 
function calls. 
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Function Result Registers 

All functions return their result in register DO except when the result is a 
64-bit real number in which case the result is returned in the DO-Dl register 
pair. Register Al is used to pass to the called routine the address in the 
runtime stack of temporary storage where a C structure- valued function is to 
write its value. That address is passed back to the calling routine in DO in the 
same way as any other address valued function. 

Temporary Registers and Register Variables 

Registers which are not reserved as described above (D2-D7, A2-A5) are 
available for two uses: First, they may be used as temporary value storage. 
Unlike the scratch registers, though, their integrity is guaranteed across 
function calls because their values are saved and restored. Second, they may 
be reserved by the user in C and by the FORTRAN and Pascal compilers as 
"register variable" locations. If the FFA option is selected, A2 is reserved as 
the floating-point accelerator base register and only registers A3 — A5 are 
available as address registers for scratch registers and register variables. 
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Calling Sequence Overview 

This section describes the procedure calling conventions as they are currently 
implemented by the Series 300 C, FORTRAN, and Pascal compilers. These 
conventions must be followed in order to interface an assembly language routine 
to one of these higher level languages. 

Calling Sequence Conventions 

The following calling conventions are used whenever a routine is called: 

■ The calling routine pushes function arguments onto the runtime stack in 
reverse order. The called routine can always access a given parameter at a 
fixed offset from %a6 (the stack frame pointer). 

■ The calling routine pops the parameters from the stack upon return. 

■ The called routine must save any registers that it uses except the scratch 
registers DO, Dl, AO, Al. The float registers can be treated as scratch 
registers, except when interfacing to Pascal. 

■ The called routine stores its return value in DO. A 64-bit real return value is 
stored in the register pair DO, Dl. 

■ The called routine uses the link instruction in its prologue code to allocate 
local data space and to set up A6 and A7 for referencing local variables and 
parameters. ( The link instruction modifies the values of A6 and A7. The 
extension of stack space is done by the HP-UX operating system when a 
%a7- relative reference would extend beyond the current stack space.) 

■ The called routine epilogue code uses the unlk and rts instructions to 
deallocate local data space and return to the calling procedure, respectively. 
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Example 

For example, consider the following simple C program, 
int z; 



mainO 








{ 










int 


x,y; 






z = 


test(x 


.y); 


> 








test(i 


o) 






int i; 








register int j ; 




{ 










int 


k; 






k = 


i + JJ 






return (k) ; 




} 









When compiled (but not optimized), it will generate assembly code like the 
following. (Comments have been added to point out features of the calling 
conventions.) 



1 


comm 


-z,4 


2 


global 


_main 


3 


_main : 




4 


link.l 


y.a6,&LFl 


5 


movm.l 


&LSl,(y.sp) 


6 


mov.l 


-8(y.a6),-(y.sp) 


7 


mov.l 


-4(y.a6),-(y.sp) 


8 


jsr 


_test 


9 


addq 


&8,y,sp 


10 


mov.l 


y.dO,.z 


11 


movm.l 


(y.sp),&Lsi 


12 


unlk 


y.a6 


13 


rts 




14 


set 


LFl,-8 



# Allocate local data space 

# Save non-scratch registers 

# Push argument "y" 

# Push argument "x" 

# Call "test" 

# Pop arguments 

# Save function result 

# Restore registers 

# Deallocate local space 

# and return 

# Gives size for local data 
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C-5 



Register mask of affected 
non-scratch registers. 



Allocate local data space 
Save non-scratch registers 

Parameter "j". Parameters 
cire at positive offsets off 
•/,a6 (moved to y,d7 because 
of the "register" declaration.) 



Local vars are at negative 

offsets off y.a6 

Put return value in */,dO 



Restore registers 
Deallocate and return 

Displacement for link to 
allocate local data space 



Immediately before execution of the jsr .test instruction (line 8), the user 
stack looks like: 



15 


set 


LS1,0 


# 


16 






# 


17 








18 


global 


_test 




19 


_test: 






20 


link.l 


y.a6,&LF2 


# 


21 


movm.l 


&LS2,(y.sp) 


# 


22 








23 


mov.l 


12(y.a6),y.d7 


« 


24 






« 


25 






# 


26 






# 


27 


mov.l 


8(y.a6),y.d0 




28 


add.l 


y.d7,y.do 




29 


mov.l 


y.d0,-4(y.a6) 


# 


30 






# 


31 


mov.l 


-4(y.a6),y.d0 


# 


32 


bra.l 


L15 




33 L15: 






34 


movm.l 


(y.sp) ,&LS2 


# 


35 


unlk 


y.a6 


# 


36 


rts 






37 


set 


LF2,-8 


# 


38 






» 


39 


set 


LS2,128 




40 


data 







Larger addresses 





' 




y 


A7-^ 


X 


(TOS) ^ 





4(%sp) 
(%sp) 



Smaller addresses 
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Following the link instruction in function test, the stack looks like: 



Larger addresses 



A7-*- 
(TOS) 



return addr 



previous A6 



12(%o6) 

8(%a6) 

4(%o6) 

(%q6) 

-4(%a5) 



Smaller addresses 
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C and FORTRAN 

This section describes some of the language-specific dependencies of C and 
Fortran. You should consult the manual pages for these compilers for further 
information. 

Assembly files can be generated by C and Fortran. You can examine the 
generated assembly files for additional information. (The only current means 
for looking at the code generated by the Pascal compiler is through the 
debugger adb.) 

Note AH stack pictures in the remainder of this document depict the 

state of the stack immediately preceding execution of the j sr 
sub.name instruction. Larger addresses are always at the top; 
the stack grows from top to bottom. 



C and FORTRAN Functions 

In C and FORTRAN, all global-level variables and functions declared by the 
user are prefixed with an underscore. Thus, a variable name xyz in C would 
be known as _xyz at the assembly language level. All global variables can be 
accessed through this name using a long absolute mode of addressing. 

C and FORTRAN push their arguments on the stack in right-to-left order. C 
always uses call-by- value, so actual argument values are placed on the stack. 
The current definition of C requires that argument values be extended to int's 
before pushing them on the stack; float's are extended to double's. 

FORTRAN'S parameter-passing mechanism is always call- by-reference, unless 
forced to call- by- value via the $ALIAS directive. In this document, all examples 
are call- by- reference. For each argument, the address of the most significant 
byte of the actual value is pushed on the stack. 

Function results are returned in register DO, or register pair DO, Dl for a 64- bit 
real result. 
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Note For exceptions to FORTRAN'S parameter-passing and 

return-value conventions, see the subsequent sections 
"FORTRAN CHARACTER Parameters", "FORTRAN 
CHARACTER Functions", and "FORTRAN C0MPLEX*8 and 
C0MPLEX*16 Functions". 

When a C structure- valued function is called, temporary storage for the return 
result is allocated on the runtime stack by the calling routine. The beginning 
address of this temporary storage space is passed to the called function through 
register Al. 

The following shows the state of the stack after a routine with n arguments is 
called. 

long func (argl, arg2, ...» argn) C 

INTEGER FUNCTION func (argl, arg2, ..., argn) FORTRAN 



argn (C: volue; FORTRAN: address of value) 



A7- 



arg2 
argl 



DO 



Will contain result value on return. 
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C and FORTRAN Functions Returning 64-Bit Double Values 

For C and FORTRAN functions which return a 64-bit double value, the stack 
looks like: 

double func (axgl, arg2, ..., argn) C 

REAL*8 FUNCTION func (argl, arg2, ..., argn) FORTRAN 



argn 



A7- 



arg2 
argl 



DO 
D1 



Most— significant 4 bytes of function value 
Least— significant 4 bytes 
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C Structure-Valued Functions 

The calling routine is responsible for allocating a result area of the proper size 
and ahgnment. It may be anywhere on the stack above the arguments, or it 
may be in static space. The address of the result area is passed to the called 
routine in register Al. 

(struct s) func (argl, arg2, ..., argn) 



Calling routine may allocate result oreo here, 
argn 



A7- 



A1 
DO 



arg2 
argl 

Address of result areo passed to called routine. 
Address of result area returned to calling routine. 



FORTRAN Subroutines 

FORTRAN subroutines have the same calling sequences as FORTRAN 
functions described above, except that no results or result areas are dealt with. 



SUBROUTINE sub (argl, arg2. 



argn) 



argn (address of actual value) 



A7- 



arg2 
argl 
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FORTRAN CHARACTER Parameters 

Each argument of type CHARACTER*n causes two items to be pushed on 
the stack. The first is a "hidden parameter" which gives the length of the 
CHARACTER argument. The second is the pointer to the argument value. 

FORTRAN CHARACTER Functions 

CHARACTER-valued FUNCTIONS are implemented differently from other 
FORTRAN functions. The calHng routine is responsible for allocating the 
result area. However, the address of the result area is neither passed to nor 
returned from the called routine in registers. Instead, after all parameters are 
pushed on the stack, the length of the return value is pushed, followed by the 
address of the return area. 

For example, suppose you call a character function as: 

INTEGER intl, int3 

CHARACTER*? strl 

CHARACTER*8 str2 

CHARACTER* 15 func, result 

result = func (intl, strl, str2, intS) 

Then the resulting stack is: 

CHARACTER*15 FUNCTION func (argl, arg2, arg3, arg4) 
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8 (size of str2) 

7 (size of strl) 

int3 (address of octuai volue) 

str2 (address of ootual value) 

str1 (address of actual value) 

intl (address of actual value) 

1 5 (size of result) 
address of result oreo 
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FORTRAN COMPLEXES and C0MPLEX*16 Functions 

All FORTRAN COMPLEX functions return their results through a result area. 
C0MPLEX*16 FUNCTION func (argl, arg2, arg3) 



A7- 



(result orea may be ollocoted here) 

arg3 (address of actual value) 

arg2 (address of actual value) 

argl (address of actual value) 

address of result orea 



Pascal 

In Pascal, any exported user-defined function is prefixed by the module name 
surrounded by underscores. A function named funk in module test would be 
known as _test_f unk to an assembly language programmer. If a procedure is 
declared to be external, as in 

procedure proc; external; 

then aU calls to proc will be represented by _proc in assembly language. 

Pascal uses both the call-by-value and call-by-reference mechanisms discussed 
for C and FORTRAN. Pascal also pushes its parameters on the stack in 
right-to-left order. All parameter information is stored in the parameter stack 
in multiples of four bytes (e.g., an argument of type char will occupy 4 bytes 
on the stack, not 1). No parameter or result area information is communicated 
to the called routine through registers. Pascal has a number of conventions not 
found in either C or FORTRAN. They are described below. 
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static Links 

All procedures and functions declared at level 2 or greater (main program 
is at level 0; contained procedures and functions are at level 1; routines 

inside these routines are at level 2, ) expect a static link word on the 

stack below all parameter information. This word contains the address of the 
enclosing routine's stack frame (i.e., the value in register A6 when the routines 
immediately surrounding the called routine is executing). The called routine 
needs this information to access intermediate (i.e., non-local, non-global) 
variables on the stack. 

Passing Large Value Parameters 

Large value parameters are passed via a copy value mechanism. Calling routines 
pass copyvalue parameters by pushing the address of the value on the stack 
(i.e., treat them the same as call-by-reference parameters). Then the called 
routine makes a local copy of the parameter by dereferencing the pointer. 

Parameter-Passing Rules 

The rules used by the Pascal compiler for passing parameters are described 
here. 

Cali-By-Reference ("var" Parameters) 

For all var parameters, push the address of the most significant byte. 

Cail-By-Value (Copyvalue Parameters) 

If a value parameter meets either of the following criteria: 

■ It is a string. 

■ It is larger than four bytes but is not a longreal or a procedure/function 
variable. 

then the address of the variable is pushed (as if by call-by- reference). Then 
the called routine uses the copyvalue mechanisim to make a local copy of the 
parameter. 
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Cali-By-Vaiue (Non-Copyvalue Parameters) 

For all longreal, procedure/function variables, and for all items that use 
four or less bytes (except strings), the value of the variable is pushed. 

Example of Parameter Passing 

The following Pascal procedure definition produces the stack below: 

procedure proc (var argl: real; 

arg2: integer; 

argS : string [3] ) ; 
/* proc is declared at level 1 

==> no static link in calling sequence */ 



A7- 



org3 (address of actuol value — copyvalue) 

orq2 (actual value) 

arg1 (address of actual value) 



Pascal Functions Return Values 

Like C and FORTRAN functions, Pascal functions return small results in 
registers DO and Dl. Larger function values are passed through a result area. 
The address of the result area is pushed before the argument values. The result 
area address is not communicated through any registers. 

The following Pascal function types return values in DO and possibly Dl: 

■ Scalar (includes char, boolean, enum, and integer). 

■ Subrange. 

■ Real. 

■ Longreal. 

■ Pointer. 
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The following Pascal function types return values through a result area: 

■ Procedure-valued. 

■ Set. 

■ Array. 

■ String. 

■ Record. 

■ File. 

Example with Static Linl( 

Suppose you've declared a Pascal procedure as: 

function func ( argl: longreal; 

var arg2: typel; 

argS : arr ay t yp e ) 
(* assume sizeof (arraytype) > 4 *) 

: longreal; 
(* func is declared at level 2 ==> static link required *) 

Then the arguments and static link would be placed on the stack as follows: 
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DO 
D1 



arg3 (address of octual value — copyvalue) 
cirg2 (address of actual value) 
argl (actual value, 4 LSB's) 
argl (actual value, 4 MSB's) 
static link (stock frame address of level 1 
routine contoining "func") 

4 MSB's of longreal result 
4 LSB's of longreal result 
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Example with Result Area 

Suppose you've declared a Pascal function of a set type, which returns the 
result in a result area: 

function fxinc ( argl: longreal; 

var arg2: typel; 
argS: arrayty ) 
(* assume sizeof (arraytype) > 4 *) 

: settype; 
(* "func" is declared at level 1 ==> no static link expected *) 

Then the resulting stack would be: 



A7- 



address of result areo 

orqZ (oddress of actuol value — copyvolue) 

arg2 (address of ootuol value) 

orgl (actual value, 4 LSB's) 

arg1 (actual value, 4 MSB's) 



Pascal Conformant Arrays 

Several words of information are passed for conformant arrays. For every 
dimension, the length (including padding bytes), upper, and lower bounds are 
pushed. Last of all, the address of the array is placed on the stack. 

Example Using Conformant Arrays 

Consider the following Pascal code which calls a subroutine, sub, which 
performs operations on a conformant array. 

var ary: array [1..3, 2.. 5] of integer; 

sub (ary) ; 
The called routine is declared as: 

procedure sub( ary[ IbL.ubl: integer; 
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Ib2..ub2: integer ] of integer ); 
(* sub declared at level 3 ==> static link required *) 

The resulting stack will be: 



A7- 



16 —length of dimension 1 
1 -lower bound of dim 1 (identifier "Ibl") 

3 -upper bound of dim 1 (identifier "ubi") 

4 -length of dimension 2 

3 —lower bound of dim 2 (identifier "Ib2") 

5 —upper bound of dim 2 (identifier "ub2") 
address of "ary" 

stotic link 



Pascal "var string" Parameters. 

var string parameters without a declared length have the maximum length 
passed as a hidden parameter. The subroutine must have this information to 
avoid writing past the end of string storage. The maximum size is pushed on 
the stack before the string address. 

For example, suppose you've written the following Pascal code: 

var string20 : string [20] ; 

sub (string20) ; 
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The routine sub is declared as: 

procedure sub (var s : string) ; 

(* "sub" declared at level 1 ==> no static link expected *) 

The resulting stack looks like: 



A7 



20 — moximum length of string 
oddress of "string20" 
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Example Programs 



This appendix provides sample assembly language programs. The intent of the 
programs is to show as many features of the as assembler as possible. 



Interfacing to C 

The following example illustrates a complete assembly example, and the 
interface of assembly and C code. The assemly source file count l.s contains 
an assembly language routine, _count_chars, which counts all the characters 
in an input string, incrementing counters in a global array (coimt). It checks 
for certain errors and uses the fprintf routine (see printf{3S)) to issue error 
messages. 

The example illustrates calling conventions between C and assem.bly code, 
including access to parameters, and the sharing of global variables between 
C and assembly routines. The variable Stderr is defined in countl .s but 
accessed in prog.c; the array count is defined in prog.c and accessed from 
count l.s. 

The cc command can be used to build a complete command from these 
sources: 

$ cc -o ccount prog.c count l.s 
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The C Source File (prog.c) 

/* Main driver for a program to count all occurences of each 

* (7-bit) ascii character in a sequence of input lines, and then 

* dump the results. The loop to do the counting is done by a 

* routine written in assembly. 
*/ 

# include <stdio.h> 

# define SMAX 100 /* majcimum string size */ 
char input_string[SMAX] ; 

# define NCHAR 128 
unsigned short count [NCHAR] ; 

extern int count_chars() ; /* Routine to do the count. It returns 

* a count of the total number of 

* characters it counted. 
*/ 

unsigned int totalcoxmt; /* Total letter count */ 
extern FILE * Stderr; 

mainO { 

Stderr = stderr; /* Set up error descriptor required by 

* count _chcLrs. 
*/ 
while (fgets(input_string, SMAX, stdin) != NULL ) 
totalcount += count_chars ( input ^string) ; 

dump_counts() ; 



dump_counts() { 
register int i; 

printfC'Char Value Count \n"); 
printf ( "========= =====:\n" ) ; 
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for (i =0; KNCHAR; i++) 

printf("\f/,02X\ty,4u\n", i, count [i]); 

printf ("\nTotal Letters Counted = '/.d\n", totalcount); 

> 

The Assembly Source File (countl.s) 

# count _ chars (s) 

# Routine to count characters in input string 

# Called as 

# count _ chars (s) 

# from C. 

# Count the occurrences of each (7-bit) ascii character in 

# the input line pointed to by "s". 

# The input lines are guaranteed to be null-terminated. 

# The counts are stored in external array 

# unsigned short count [NCHAR] 

# where NCHAR -in 128. 

# Give an error (using f printf from libc) if 

# * an input char in not in the 7-bit ascii range. 

# * the count overflows for a given character. 

# The return value is the totcil number of chars counted. 

# Illegal characters cire not included in the total character 

# count . 

# Calling routine must set global variable Stderr to file 

# descriptor for error messages. We make this require because a C 

# program can more portably calculate the necessary address. 

global .count # Array of unsigned short for storing 

# is defined externally 
global _f printf # External function 

global _count_chars # Make _ count _ characters visible 

# externally 

# Register usage: 

# NOTE: We don't use scratch registers for variables we would 
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want preserved across calls to _printf . An alternative strategy 
would be to use all scratch registers and save them ciround amy 
calls to _printf , on the assumption that such calls are rare. 



y.a2 
y.a3 
y.d2 

y.di 



address of count [] array 
step through input string 
total character count 
value of current character 



(scratch register) 



global _Stderr 



# Stderr file descriptor - must be 

# externally set. 



bss 




_Stderr : 


space 4 


text 




_ county chars: 


link.l 


y.a6,&-12 # 


movm.l 


y.a2-y.a3/y.d2,(y.sp) 


mov.l 


&_couiit,y.a2 # 


mov.l 


8(y.a6),y.a3 # 


clr.l 


y.d2 # 


Loop : 




mov.b 


(y.a3)+,y.di # 


beq.b 


Ldone # 


bmi.b 


Lneg # 


addq.l 


&l,y.d2 # 


ext.w 


y.dl # 


addq.w 


&l,(y.a2,y.dl.w*2) 


bcs.b 


Lovflw 


bra.b 


Loop # 



No local vars. 3 registers to save 

Count array 

Input string pointer 

Total character count 

Next character 

Null character terminates string 
Illegal character 
Increment total count 
Meike y,dl usuable as an index 
# Increment the appropriate 



# Go back for next character 



Lneg: # illegal chairacter seen — give an error 

# push args for fprintf , in reverse order 
and.l &Oxff ,y,dl # Only want low 2 bytes in arg passed, 
mov.l y.dl,-(y.sp) 
mov . 1 &Errl , - (Xsp) 
mov.l .Stderr,- (y,sp) 
j sr _f printf 
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add.l &12,y,sp 
bra.b Loop 



# Pop the 3 arguments 

# Go back for next character 



Lovflw: # count overflowed — give an error 

# push args for fprintf , in reverse order 
and.l ftOxff ,y.dl # Only want low 2 bytes in arg passed, 
mov.l y.dl,-(y,sp) 
mov.l &Err2,-(y,sp) 
mov.l _Stderr,-(y,sp) 
j sr _f printf 

add.l &12,y,sp # Pop the 3 arguments 
bra.b Loop # Go back for next character 



Ldone : 

mov.l y.d2,y,d0 # retiirn value 
movm.l (y,sp) ,y,a2-y,a3/y,d2 # restore registers 
unlk y.a6 
rts 



data 
Errl: asciz "Illegal character (y,02X) in input \n" 
Err2: asciz "Count overflowed for character (y,02X)\n" 
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Using MC68881/2 and MC68040 
Floating-Point Instructions 

The following assembly language program uses MC68881/2 and MC68040 
floating-point instructions to approximate a fresnel integral. 

# 

# double fresnel (z) double 2; 
# 

# Approximate fresnel integral by calculating first hundred terms 

# of series expansion. For n=0 to n=99, each term is: 
« 

# (-l)~n * (PI/2)^(2*n) * z~(4*n+l) 

# 

# (2*n)! * (4*n+l) 



set 



PI,0 



text 








global 


_fresnel 






_f resnel : 








link 


y.a6,&-8 






mov.l 


7.d2,-4(y.a6) 


# 


save d2 


fmov 


y.fpcr,-8(y.a6) 


# 


save control register 


fmov 


&0,y.fpcr 


# 


disable traps; round to 






# 


nearest extended format 


movq 


&o,y.do 


# 


n 


movq 


&i,y,di 


# 


4*n+l 


fmov . w 


&o,y.fpo 


# 


initialize sum 


fmov . b 


&i,y,fpi 


# 


(pi/2)~(2*n) 


fmov . d 


8(y,a6),y.fp3 


# 


z 


fmov 


y.fp3,y.fp2 


# 


initialize z~(4*n+l) 


fmul 


y.fp3,y.fp3 


# 


z^2 


fmul 


y.fp3,y.fp3 


# 


z^4 


fmov . b 


&i,y.fp4 


# 


initialize (2*n) ! 


fmovcr 


&pi,y,fp5 


# 


pi 


fdiv.b 


&2,y.fp6 


« 


pi/2 


fmul 


y.fp5,y.fp5 


# 


(pi/2) '2 


loop : 
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fmov 


y.fpl,7.fp6 


# 


(pi/2)~(2*n) 


fdiv 


y.fp4,7.fp6 


# 


divide by (2*n) ! 


fdiv.l 


y.di,y.fp6 


« 


divide by 4*n+l 


fmul 


y.fp2,y.fp6 


# 


multiply by z"(4n+l) 


movq 


&i,y.d2 






and.b 


y.do,y.d2 


« 


odd or even term? 


bne.b 


Ll 






fadd 


y.fp6,y.fpo 


# 


add term 


bra.b 


L2 






LI: fsub 


y.fp6,y.fpo 


# 


subtract term 


L2: addq.l 


&i,y.do 


# 


n=n+l 


cmp.l 


y.do,&ioo 


« 


end of loop? 


beq.b 


L3 






mov.l 


y.do,y.d2 


# 


new n 


asl.l 


&l,y.d2 


# 


n*2 


fmul.l 


y.d2,y.fp4 


« 


update (2*n) ! 


subq.l 


&l,y.d2 






fmul.l 


y.d2,y.fp4 






addq.l 


&4,y.dl 


# 


update 4*n+l 


fmul 


y.fp3,y.fp2 


# 


update z"(4*n+l) 


fmul 


y.fp5,y.fpi 


# 


update (pi/2)"(2*n) 


bra.b 


loop 






L3: fmov.d 


y.fpo,-(y.sp) 


# 


get result 


movm.l 


(y.sp)+,y.do-y.di 






mov.l 


-4(y.a6),y.d2 


# 


restore d2 


fmov 


-8(y.a6),y.fpcr 


# 


restore control register 


unlk 


y,a6 
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Translators 



Two assembly source translators are provided to assist in converting assembly 
code from other HP systems to as assembly language for Series 300/400 
computers. 



atrans 

The atrans translator converts Pascal Language System (PLS) assembly 
language to as assembly language format. For details on using the atrans 
command, see atrans (1). 



astrn 

The as assembler uses a UNIX-like assembly syntax which differs in several 
ways from the syntax of previous HP-UX assemblers. The astrn translator 
translates old HP-UX Series 200/300 assembly language to the new as 
assembly language for Series 300/400 HP-UX systems, for details on the astrn 
command, see astrn{l). 

Note The translators are able to perform most of the translation to 

as assembly language format. However, some translation is 
beyond the capabilities of the translators. Lines that require 
human intervention to change will generate warning messages. 
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Unsupported Instructions 

for Series 300/400 Computer's 



HP-UX Series 300/400 assemblers support the complete MC68010 and 
MC68020/30/40 instruction sets. However, certain instructions are provided 
only on certain processors. These instructions are: 

■ tas 

■ cas 

■ cas2 

■ bkpt 

The assembler generates code for these instructions, but gives warning 
messages that the instructions are not fully supported by the Series 300 
hardware. The following table shows which of the above instructions are 
supported or not supported on various models. 

Model(s) Instructions Not Supported 

310 The tas instruction is not supported by the Model 310. 

Executing a tas instruction generates a bus error or corrupt 
memory. 

The instructions cas and cas2 are illegal instructions. These 
instruction will cause normal exception processing for an illegal 
instruction. 

The bkpt instruction is not iUegal, but it will end up in illegal 
instruction processing. 

320 The instructions tas, cas, and cas2 will execute; however, 

they may cause cache consistency problems. These instructions 
completely bypass the cache, so if you reference the same 
memory locations with a different instruction you will get the 
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old data stored in the cache instead of the new data written to 
memory. 

The bkpt instruction will cause illegal instruction exception 
processing. 

318/319, 330, The instructions tas, cas, and cas2 execute properly because 
332 there is no cache to be inconsistent. 

The bkpt instruction causes illegal instruction exception 
processing. 

345, 350, 360, The instructions tas, cas, and cas2 execute properly. The 
370, 375 cache consistency is maintained. 

The instruction bkpt will cause illegal instruction exception 
processing. 

380, 4xx None. Model 380 and all 4xx models support all instructions. 
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adb 



adb is a debugging program that is available on HP-UX. It provides capabilities 
to look at core files resulting from aborted programs, print output in a variety 
of formats, patch files, and run programs with embedded breakpoints. This 
appendix provides examples of the more useful features of adb. 



adb Syntax 

The syntax of the adb command is: 

adb [ "W ] [ objfile [ corefile ] ] 

where objfile is an executable HP-UX file and corefile is a core image file. 
Often times, adb is invoked as: 

adb a. out core 

If adb is invoked without arguments: 

adb 

then the defaults are a. out and core respectively. The filename minus (-) 
means "ignore this argument," as in: 

adb - core 

The objfile can be written to if adb is invoked with the -w flag as in: 

adb -w a. out - 

adb catches signals; therefore, a user cannot use a quit signal to exit from adb. 
The request $q or $Q (or [CTRLl - fpl ) must be used to exit from adb. 

For details on invoking adb, see adb{l). 
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adb Command Format 

You interact with adb by typing requests. The general format of a request is: 

[ address] [ , count] [command] [ modifier] 

adb maintains a current address, called dot. When address is entered, dot is set 
to that location. The command is then executed count times. 

Address and count are represented by expressions. You can create expressions 
from decimal, octal, and hexadecimal integers, and symbols from the program 
under test. These may be combined with the following operators: 

+ addition 

subtraction or negation (when used as a unary operator) 

* multiplication 
*/. integer division 
& bitwise AND 

I bitwise inclusive OR 

# round up to the next multiple 
unary not. 

All arithmetic within adb is 32 bits. 

When typing symbolic names from high-level languages, such as C or 
FORTRAN, type name or ^name; adb will recognize both forms. The default 
base for integer input is initialized to hexadecimal, but can be changed. 

(CTRL) -fcl terminates execution of any adb command. 

Table G-1 illustrates some commonly used adb commands and their meanings. 
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Table G-1. Commonly Used adb Commands 



Command 


Description 


7 


Print contents from a . out file 


/ 


Print contents from core file 


= 


Print value of "dot" 


: 


Breakpoint control 


$ 


Miscellaneous requests 


» 


Request separator 


! 


Escape to shell 



Displaying Information 

adb has requests for examining locations in either the objfile or the corefile. 
The ? request examines the contents of objfile, the / request examines the 
corefile. 

Following the ? or / command the user specifies a format. 

The following are some commonly used format letters: 

c one byte as a character 

X two bytes in hexadecimal 

X four bytes in hexadecimal 

d two bytes in decimal 

F eight bytes in double floating point 

i MC68xxx instruction 

s a null-terminated character string 

a print in symbolic form 

n print a newline 

r print a blank space 
backup dot. 
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A command to print the first hexadecimal element of an array of long integers 
named ints in C would look like: 

ints/X 

This instruction would set the value of dot to the symbol table value of _ints. 
It would also set the value of the dot increment to four. The dot increment is 
the number of bytes printed by the format. 

Let us say that we wanted to print the first four bytes as a hexadecimal 
number and the next four as a decimal one. We could do this by: 

ints/XD 

In this case, dot would still be set to _ints and the dot increment would be 
eight bytes. The dot increment is the value which is used by the newline 
command. Newline is a special command which repeats the previous 
command. It does not always have meaning. In this context, it means to 
repeat the previous command using a count of one and an address of dot plus 
dot increment. In this case, newline would set dot to ints+0x8 and type the 
two long integers it found there, the first in hex and the second in decimal. 
The newline command can be repeated as often as desired and this can be 
used to scroll through sections of memory. 

Using the above example to illustrate another point, let us say that we wanted 
to print the first four bytes in long hex format and the next four bytes in byte 
hex format. We could do this by: 

ints/X4b 

Any format character can be preceded by a decimal repeat character. 

The count field can be used to repeat the entire format as many times as 
desired. In order to print three lines using the above format we would type 

ints,3/X4bn 

The n on the end of the format is used to output a carriage return and make 
the output much easier to read. 

In this case the value of dot will not be _ints. It will rather be _ints+OxlO. 
Each time the format was re-executed dot would have been set to dot plus 
dot increment. Thus the value of dot would be the value that dot had at the 
beginning of the last execution of the format. Dot increment would be the size 
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of the format: eight bytes. A newline command at this time would set dot to 
ints+0xl8 and print only one repetition of the format, since the count would 
have been reset to one. 

In order to see what the value of dot is at this point the command 



could be typed, = is a command which can be used to print the value of 
address in any format. It is also possible to use this command to convert from 
one base to another: 

0x32=oxd 

This will print the value 0x32 in octal, hexadecimal and decimal. 

Comphcated formats are remembered by adb. One format is remembered for 
each of the ? , / and = commands. This means that it is possible to type 

0x64= 

and have the value 0x64 printed out in octal, hex and decimal. And after that, 
type 

ints/ 

and have adb print out four bytes in long hex format and four bytes in byte 
hex format. To an observant individual it might seem that the two commands 

main,10?i 
and 

main?10i 

would be the same. 

There are two differences. The first is that the numbers are in a different base. 
The repeat factor can only be a decimal constant, while the count can be an 
expression and is therefore, by default, in a hex base. 

The second difference is that a newline after the first command would print 
one line, while a newline after the second command would print another ten 
lines. 
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Debugging C Programs 

The following examples illustrate various features of adb. Certain parts of the 
output (such as machine addresses) may depend on the hardware being used, 
as well as how the program was linked (unshared, shared, or demand loaded). 

Debugging a Core Image 

Consider the C program in Figure G-1. The program is used to illustrate some 
of the useful information that can be obtained from a core file. The object 
of the program is to calculate the square of the variable ival by calling the 
function sqr with the address of the integer. The error is that the value of the 
integer is being passed rather than the address of the integer. Executing the 
program produces a core file because of a bus error. 



int intsC]= {1,2,3,4,5,6,7,8,9,0, 
1,2.3,4,5,6,7,8,9,0, 
1,2,3,4,5,6,7,8,9,0, 
1,2,3,4,5,6,7,8,9,0>; 
int ivcd; 
mainO 
•C 

register int i; 
for(i=0;i<10;i++) 
•C ivcQ. = ints [i] ; 

sqr (ival) ; 

printfC'sqr of '/.d is y.d\n", ints [i] , ival) ; 
> 



sqr(x) 
int *x; 

i 

y 



*x *= *x; 



Figure G-1. C Program with a Pointer Bug 

adb is invoked without arguments: 
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adb 

The first debugging request: 

$c 

is used to give a C backtrace through the subroutines called. This request 
can be used to check the validity of the parameters passed. As shown in 
Figure G-2, the value passed on the stack to the routine sqr is 1, which is not 
what we are expecting. 



$c 

_main+0x30 : 

start+0x58: 

$r 

ps 0x0 

pc OxllC 

sp 0xFFFF7D84 



_sqr (0x1) 

.main (0x1, OxFFFFTDAC) 



_sqr+0x42 : 



iinlk 



7.a6 



dO 0xlAE9 




aO 


0x1 




dl 0x53 




al 


0XFFFF7DAC 


d2 OxFFCOl 




a2 


0xFFC8A004 


dS 0xFFC8F405 




a3 


0X1F626 


d4 0xFFC8F401 




a4 


0X1F66C 


d5 0x700 




a5 


0X1F3AC 


d6 0x0 




a6 


0xFFFF7D88 


sqr+0x38,5?ia 










_sqr+0x38 : 




mov.w 


(y.a7) + ,y.d0 


_sqr+0x3A: 




mulu . w 


y.dl,y.dO 


_sqr+0x3C: 




mov.l 


Ox8(y.a6),7.a0 


_sqr+0x40 : 




mov.l 


y.do,(y.ao) 


_sqr+0x42: 




unlk 


y.a6 


_sqr+0x44: 










$e 










flag_68881: 


0x10000 






.environ : 


0xFFFF7DB4 




_argc_ value: 


0x1 








float.soft: 


OxFFFFOOOl 
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axgv_ value: 


OxFFFFTDAC 


ints: 0x1 




ival: 0x1 




_iob: 0x0 




.ctype: 


0x202020 


,_buf endtab: 


0x0 


_smbuf : 


0x0 


_lastbuf : 


0x39D4 


ermo: 0x0 




,_stdbiif : 


Ox40DC 


._sobuf : 


0x0 


,_sibuf : 


0x0 


,asm_mhfl: 


0x0 


.end: 0x0 




.ermet : 


0x0 


.edata: 0x1 





Figure G-2. adb Output from Program of Figure 1-1 



The next request 

$r 

prints out the registers including the program counter and an interpretation of 
the instruction at that location. The instruction printed for the pc does not 
always make sense. This is because the pc has been advanced and is either 
pointing at the next instruction, or is left at a point part way through the 
instruction that failed. In this case the pc points to the next instruction. In 
order to find the instruction that failed we could list the instructions and their 
offsets by the following command: 

sqr+0x38,5?ia 

This would show us that the instruction that failed was 

_sqr+0x40:move.l /.dO, C/.aO) 

This is the first instruction before the value of the pc. The value printed out 
for register aO also indicates that a write to location 0x1, which is in the text 
part of the user space, would fail in a shared a . out file. The text segment is 
write-protected in files that are shared or demand-loaded. 
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The request: 

$e 
prints out the values of all external variables at the time the program crashed. 
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Setting Breakpoints 

Consider the C program in Figure G-3, which program changes tabs into 
blanks. 



#include <stdio.h> 




#define 


MAXLINE 80 




#def ine 


YES 


1 


#define 


NO 





#define 


TABSP 


8 


char 


input [] = "data' 


> 


FILE 


^stream; 




int 


tabs [MAXLINE] ; 




char 


ibuf [BUFSIZ] ; 




mainO 






< 


int col, *ptab; 
char c; 





setbnf ( stdout , ibuf ) ; 
ptab = tabs; 

settab(ptab) ; /*Set initial tab stops */ 
col = 1; 

if ((stream = fopen(inpiit ,"r")) == NULL) { 
printf("y,s : not f oundWn", input ) ; 
exit (8); 
} 

while((c = get c( stream)) != EOF) i 
switch(c) { 

case ' \t ' : /* TAB */ 

while (tabpos (col) != YES) { 

putcharC '); /* put BLANK */ 
col++ ; 
} 

brealc; 
case '\n': /*NEWLINE */ 

putchar('\nO; 
col = 1; 
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break; 
default : 

putchar(c) ; 
C0I++ ; 



/* Tabpos return YES if col is a tab stop */ 

tabpos(col) 

int col; 

■C 

if (col > MAXLINE) 

return (YES) ; 
else 

return (tabs [col] ) ; 
> 

/* Settab - Set initial tab stops */ 

settab(tabp) 

int *tabp; 

int i; 

for(i = 0; i<= MAXLINE; i++) 

(iy,TABSP) ? (tabsCi] = NO) : (tabs[i] = YES); 
> 

Figure G-3. C Program to Decode Tabs 

We will run this program under the control of adb (see Figure G-4) by: 

adb a. out - 
Breakpoints are set in the program as: 

address ih [request] 

The requests: 

settab+e:b 
fopen+4:b 
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tabpos+e:b 

set breakpoints at the starts of these functions. The addresses for user-defined 
functions (settab and tabpos) are entered as s3rmbol+e so that they will 
appear in any C backtrace; this is because the first few instructions of each 
function are instructions which link in the new function. Note that one 
of the functions, f open, is from the C library; for this routine, f open+4 is 
appropriately used. 



$ adb a. out - 

executable file = a. out 

ready 

settab+e:b 

f open+4 :b 

tabpos+e:b 

$b 

breakpoints 

count bkpt command 

0x1 _tabpos+OxE 

0x1 _fopen+0x4 

0x1 _settab+OxE 

:r 

process 5139 created 

a. out: running 

breakpoint _settab+OxE: clr.l -0x4 ('/.aC) 

settab+e:d 



:c 








a. out: running 








breakpoint 


_fopen+0x4: jsr 


.findiop 




$c 
_main+0x48 : 


_fopen (0x4000, 0x4006) 






start +0x58: 


.main (0x1, OxFFFFTDAC) 






tabs/24X 








.tabs: 


0x1 0x0 


0x0 


0x0 




0x0 0x0 


0x0 


0x0 




0x1 0x0 


0x0 


0x0 




0x0 0x0 


0x0 


0x0 
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0x1 
0x0 



0x0 
0x0 



0x0 
0x0 



0x0 
0x0 



a . out : running 

breakpoint _tabpos+OxE: 



movq &0x50,y.d0 



:s 



a . out : running 
stopped at 

( Return ) 

a . out : running 
stopped at 

[ Return ] 

a . out ; running 
stopped at 

( Return ) 

a. out: running 
stopped at 

( Return ) 

a . out : running 
stopped at 

( Return ) 

a, out: running 
stopped at 

( Return ] 

a . out : running 
stopped at 
:d* 



_tabpos+OxlO: cmp.l y,d0,0x8(y,a6) 



_tabpos+0xl4: bge.w _tabpos+OxlE 



_tabpos+OxlE: mov.l 0x8(y,a6) //.dO 



_tabpos+0x22 : asl . 1 &0x2 , y,dO 



_tabpos+0x24: addi.l &0x4A50,7.d0 



_tabpos+0x2A: 



_tabpos+0x2C : 



mov.l y,dO,y,aO 
mov.l (y.aO),y,dO 



:c 

a . out : running 

This is it 

process terminated 

settab+e:b settab,5?ia 

tabpos+e,3:b ibuf/20c 

:r 

process 5248 created 

a . out : running 

settab,5?ia 

_settab: 



mov.l y,a6,~(y.a7) 
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_SGttab+0x2: 




mov.l 


y.a7,y.a6 


_S6ttab+0x4: 




add.l 


&0xFFFFFFFC,y.a7 


_settab+OxA: 




movm.l 


<>,(y.a7) 


_settab+OxE: 




clr.l 


-0x4(y.a6) 


_settab+0xl2: 








breakpoint 

'. c 




_settab+OxE: 


clr.l -0x4(y.a6) 


a. out: running 






ibuf/20c 








_ibuf : 




This 




ibuf/20c 








_ibuf : 




This 




ibuf/20c 








_ibuf: 




This 




breakpoint 




_tabpos+OxE: 


movq &0x50,y.d0 


$q 








process 5248 


killed 





Figure G-4. adb Output from C Program of Figure 1-3 

To print the location of breakpoints type: 

$b 

The display indicates a count field. A breakpoint is bypassed count — 1 times 
before causing a stop. The command field indicates the adb requests to be 
executed each time the breakpoint is encountered. In our example no command 
fields are present. 

By displaying the original instructions at the function settab we see that the 
breakpoint is set after the instruction to save the registers on the stack. We 
can display the instructions using the adb request: 

settab, 5? ia 

This request displays five instructions starting at settab with the addresses of 
each location displayed. 

To run the program simply type: 

:r 
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To delete a breakpoint, for instance the entry to the function settab, type: 

settab+4:d 
To continue execution of the program from the breakpoint type: 

:c 

Once the program has stopped (in this case at the breakpoint for f open), adb 
requests can be used to display the contents of memory. For example: 

$c 

to display a stack trace, or: 

tabs,3/8X 

to print three lines of 8 locations each from the array called tabs. The format 
X is used since integers are four bytes on M680x0 processors. By this time (at 
location f open) in the C program, settab has been called and should have set 
a one in every eighth location of tabs. 



Advanced Breakpoint Usage 

When we continue the program with: 

:c 

we hit our first breakpoint at tabpos since there is a tab following the "This" 
word of the data. We can execute one instruction by 

:s 



and can single step again by pressing the ( Return ) key. Doing this we can quickly 
single step through tabpos and get some confidence that it is working. We can 
look at twenty characters of the buffer of characters by typing: 

>ibuf/20c 

Several breakpoints of tabpos will occur until the program has changed the tab 
into equivalent blanks. Since we feel that tabpos is working, we can remove all 
the breakpoints by: 

:d* 
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If the program is continued with: 

:c 

it resumes normal execution and continues to completion after adb prints the 
message: 

a . out : rumiing 

It is possible to add a list of commands we wish to execute as part of a 
breakpoint. By way of example let us reset the breakpoint at settab and 
display the instructions located there when we reach the breakpoint. This is 
accomplished by: 

settab+e:b settab, 5?ia 

It is also possible to execute the adb requests for each occurrence of the 
breakpoint but only stop after the third occurrence by typing: 

tabpos+e,3:b ibuf/20c 

This request will print twenty character from the buffer of characters at each 
occurrence of the breakpoint. 

If we wished to print the buffer every time we passed the breakpoint without 
actually stopping there we could type 

tabpos+e,-l:b ibuf/20c 

A breakpoint can be overwritten without first deleting the old breakpoint. For 
example: 

settab+e:b settab, 5?ia;ptab/o 

could be entered after typing the above requests. The semicolon is used to 
separate multiple adb requests on a single line. 

Now the display of breakpoints: 

$b 

shows the above request for the settab breakpoint. When the breakpoint at 
settab is encountered the adb requests are executed. 
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Note Setting a breakpoint causes the value of dot to be changed; 

executing the program under adb does not change dot. 
Therefore: 

settab+e;b . ,5?ia 
fopen+4:b 

will print the last thing dot was set to (in the example f open) 
not the current location (settab) at which the program is 
executing. 

The HP-UX quit and interrupt signals (SIGQUIT and SIGINT; see signal{2)) 
act on adb itself rather than on the program being debugged. If such a signal 
occurs then the program being debugged is stopped and control is returned to 
adb. The signal is saved by adb and is passed on to the test program if: 

:c 

is typed. This can be useful when testing interrupt handling routines. The 
signal is not passed on to the test program if: 

:c 

is typed. 



Other Breakpoint Facilities 

To pass arguments to a program and redirect standard input and output, use 
the :r request as: 



:r 



argl [arg2^ ... <infile > outfile 



This request kills any existing program under test and starts the a. out 
afresh. The process will run until a breakpoint is reached or until the program 
completes or crashes. To start the program without running it, the command 

:e argl [arg2\ ... <infile > outfile 
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can be executed. This will start the process, and leave it stopped without 
executing the first instruction. 

If the program is stopped at a subroutine call it is possible to step around the 
subroutine by 

:S 

This sets a temporary breakpoint at the next instruction and continues. This 
may cause unexpected results if :S is executed at a branch instruction. 

adb allows a program to be entered at a specific address by typing: 

address :t 
The count field can be used to skip the first n breakpoints as: 

,72:r 
The request: 

,n:c 

may also be used for skipping the first n breakpoints when continuing a 
program. 

A program can be continued at an address different from the breakpoint by: 

address : c 
The program being debugged runs as a separate process and can be killed by: 

:k 
All of the breakpoints set so far can be deleted by 

:d* 
A subroutine may be called by 

:x address [parameters] 
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Maps 

HP-UX supports various executable file formats that determine how the file is 
loaded by exec. A shared text program file is the most common and is the 
default executable file format generated by the linker. Unshareable text is 
produced by linking the program with the -N linker option. Demand-loadable 
format is produced by linking with the -q option. (For details on the different 
executable file formats, refer to Programming on HP-UX.) adb interprets these 
different file formats and provides access to the different segments through the 
maps. To print the maps, type: 

$m 

In unshareable files, both text (instructions) and data are intermixed. In 
shared files the instructions are separated from data, and the adb request ?* 
accesses the data part of the a. out file. The ?* request tells adb to use the 
second part of the map in the a. out file. Accessing data in the core file shows 
the data after it was modified by the execution of the program. Notice also 
that the data segment may have grown during program execution. Figure G-5 
shows the display of three maps for the same program linked as unshareable, 
shareable, and demand-loaded, respectively. The b, e, and f fields are used 
by adb to map addresses into file addresses. The f 1 field is the length of the 
header at the beginning of the file. The f 2 field is the displacement from the 
beginning of the file to the data. For a nonshared file with mixed text and data 
this is the same as the length of the header; for shared files this is the length of 
the header plus the size of the text portion. 

$ adb manex.nshtxt core.nshtxt 

executable file = manex.nshtxt 

core file = core.nshtxt 

ready 

$m 

? map 'manex.nshtxt' 

bl = 0x0 el = 0x5D8 f 1 = 0x40 

b2 = 0x0 e2 = 0x5D8 f 2 = 0x40 

/ map * core.nshtxt' 

Kernel: b = 0xl40ECC e = 0xl40F08 f = 0x10 

Exec: b = 0xl40E7C e = 0xl40ECC f = 0x5C 

adb G-19 



Core; b = 0xl40E6C e = 0xl40E70 f = OxBC 

Data: b = 0x0 e = 0x2000 f = OxDO 

Stack: b = OxFFEFFOOO e = OxFFFOOOOO f = 0x20E0 

Registers: b = 0xl40BB4 e = 0xl40DFC f = OxSOFO 

/ map (inactive) 'core.nshtxt' 

bl = 0x0 el = 0x1000000 fl = 0x0 

b2 = 0x0 e2 = 0x1000000 f2 = 0x0 

$v 

variables 

d = 0x2000 

e = 0xC4 

m = 0x107 

s = 0x1000 

t = 0x394 

$q 

$ adb manex.shtxt core.shtxt 

executable file = manex.shtxt 

core file - core.shtxt 

ready 

$m 

? map 'manex.shtxt' 

bl = 0x0 el = 0x394 f 1 = 0x40 

b2 = 0x1000 e2 = 0x1244 f2 = 0x3D4 

/ map * core.shtxt* 

Kernel: b = 0xl40E64 e = Oxl40EAO f = 0x10 

Exec: b = 0xl40E14 e = 0xl40E64 f = 0x5C 

Core: b = 0xl40E04 e = Oxl40E08 f = OxBC 

Data: b - 0x1000 e = 0x3000 f = OxDO 

Stack: b = OxFFEFFOOO e = OxFFFOOOOO f == 0x20E0 

Registers: b = 0xl40B4C e = 0xl40D94 f = 0x30F0 

/ map (inactive) * core.shtxt' 

bl = 0x0 el = 0x1000000 fl = 0x0 

b2 = 0x0 e2 = 0x1000000 f2 = 0x0 

$v 

variables 

b = 0x1000 

d = 0x2000 
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G = 0xC4 
m = 0x108 
s = 0x1000 
t = 0x394 
$q 

$ adb manex . dltxt core.dltxt 

executable file = manex . dltxt 

core file = core.dltxt 

ready 

$m 

? map 'manex. dltxt' 

bl = 0x0 el = 0x394 fl = 0x1000 

b2 = 0x1000 e2 = 0x1244 f2 = 0x2000 

/ map 'core.dltxt' 

Kernel: b = 0xl40E64 e = 0xl40EA0 f = 0x10 

Exec: b = 0xl40E14 e = 0xl40E64 f = 0x5C 

Core: b = 0xl40E04 e = 0xl40E08 f = OxBC 

Data: b = 0x1000 e = 0x3000 f = OxDO 

Stack: b = OxFFEFFOOO e = OxFFFOOOOO f = 0x20E0 

Registers: b = Oxl40B4C e = 0xl40D94 f = OxSOFO 

/ map (inactive) 'core.dltxt' 

bl = 0x0 el = 0x1000000 fl = 0x0 

b2 = 0x0 e2 = 0x1000000 f2 = 0x0 

$v 

variables 

b = 0x1000 

d = 0x2000 

e = 0xC4 

m = OxlOB 

s = 0x1000 

t = 0x394 

$q 

Figure G-5. Maps Produced by adb 
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The jRle address associated with a memory address is determined by a triple 
(6,e/) using the this formula: 

if (6 < address < e), then the file address = address -\- f — b 

If an address does not satisfy the "if condition of any triple in the map, it is 
invalid. 

The objectfile has two such triples, one for the text segment and one for the 
data segment. The user-modifiable map for the corefile also has two triples. 
The initial map for the core file has as many triples as there are core segments 
in the core file (see core (4)). 

Two additional requests are used with maps: 

=m Toggle the address mapping of corfil between the initial map 

set up for a valid core file and the default mapping pair 
which the user can modify with /m. If the corfil was invalid, 
only the default mapping is available. 

[?/]m bl el fl[t/] Record new values for {bl,el Jl). If less than three 

expressions are given, the remaining map parameters are 
left unchanged. If the ? or / is followed by *, the second 
segment {b2,e2J2) of the mapping is changed. If the list 
is terminated by ? or /, the file (object file or core file, 
respectively) is used for subsequent requests. For example, 
/m? causes / to refer to the object file. A /m command 
switches the core file mapping to the default mapping pair. 
For a valid core file, the =m command can be used to switch 
back to the initial mapping. 
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Variables and Registers 

adb provides a set of variables which are available to the user. A variable is 
composed of a single letter or digit. It can be set by a command such as 

0x32>5 
which sets the variable 5 to hex 32. It can be used by a command such as 

<5=X 

which will print the value of the variable 5 in hex format. 

Some of these variables are set by adb itself. These variables are: 

last value printed 

b base address of data segment 

d length of the data segment 

e the entry point 

m execution type (0x107 (nonshared), 0x108 (shared), or OxlOb (demand 

loaded)) 

s length of the stack 

t length of the text 

These variables are useful to know if the file under examination is an 
executable or core image file, adb reads the header of the core image file to 
find the values for these variables. If the second file specified does not seem 
to be a core file, or if it is missing, the header of the executable file is used 
instead. 

Variables can be used for such purposes as counting the number of times a 
routine is called. Using the example of Figure G-3, if we wished to count the 
number of times the routine tabpos is called we could do that by typing the 
sequence 

0>5 

tabpos+4,-l:b <5+l>5 

:r 
<5=d 
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The first command sets the variable 5 to zero. The second command sets a 
breakpoint at tabpos+4. Since the count is -1 the process will never stop there 
but adb will execute the breakpoint command every time the breakpoint is 
reached. This command will increment the value of the variable 5 by 1. The :r 
command will cause the process to run to termination, and the final command 
will print the value of the variable. 

$v can be used to print the values of all non-zero variables. 

The values of individual registers can be set and used in the same way as 
variables. The command 

0x32>d0 

will set the value of the register dO to hex 32. The command 

<dO=X 

will print the value of the register dO in hex format. The command $r will 
print the value of all the registers. 



Formatted Dumps 

It is possible to combine adb formatting requests to provide elaborate displays. 
Below are some examples. 

The line: 

<b,-l/4o4^8Cn 

prints 4 octal words followed by their ASCII interpretation from the data space 
of the core image file. Broken down, the various request pieces mean: 

<b The base address of the data segment. 

<b,-l Print from the base address to the end of file. A negative count is used 
here and elsewhere to loop indefinitely or until some error condition 
(like end of file) is detected. 

The format 4o4''8Cn is broken down as follows: 

4o Print 4 octal locations. 
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4'" Backup the current address 4 locations (to the original start of the 
field). 

8C Print 8 consecutive characters using an escape convention; each 
character in the range to 037 is printed as @ followed by the 
corresponding character in the range 0140 to 0177. An @ is printed as 

m. 

n Print a newline. 

The request: 

<b,<d/4o4^8Cn 

could have been used instead to allow the printing to stop at the end of the 
data segment (<d provides the data segment size in bytes). 

The formatting requests can be combined with adb's ability to read in a script 
to produce a core image dump script, adb is invoked as: 

adb a. out core < dump 

to read in a script file, dump, of requests. An example of such a script is: 

120$w 

4095$s 

$v 

=3n 

$m 

=3n"C Stack Backtrace" 

$C 

=3n"C External Variables" 

$e 

=3n" Registers" 

$r 

0$s 

=3n"Data Segment" 

<b,-l/8ona 

The request 120$w sets the width of the output to 120 characters (normally, 
the width is 80 characters), adb attempts to print addresses as: 

symbol + offset 
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The request 4095$s increases the maximum permissible offset to the nearest 
symbolic address from 255 (default) to 4095. The request = can be used to 
print literal strings. Thus, headings are provided in this dump program with 
requests of the form: 

=3n"C Stack Backtrace" 

that spaces three lines and prints the literal string. The request $v prints all 
non-zero adb variables. The request 0$s sets the maximum offset for symbol 
matches to zero thus suppressing the printing of symbolic labels in favor of 
octal values. Note that this is only done for the printing of the data segment. 
The request: 

<b,~l/8ona 

prints a dump from the base of the data segment to the end of file with an 
octal address field and eight octal numbers per line. 

Figure G-7 shows the results of some formatting requests on the C program of 
Figure G-6. 



char strl[] = "Tliis is a character string"; 

int one = 1; 

int niimber = 456; 

long Intutt = 1234; 

iloat fpt = 1.25; 

char str2n = "This is the second character string"; 

mainO 

{ 

one = 2; 
> 

Figure G-6. Simple C Program Tliat Illustrates Formatting and Patching 

$ adb a . out . sheared - 



executable file 
ready 
<b,-l?8oiia 
_strl : 


= a. out. shared 
052150 064563 


020151 


071440 


060440 


061550 


060562 


060543 


_strl+OxlO: 


072145 071040 


071564 


071151 


067147 








01 


_ntmber : 
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.lumber: 0710 02322 037640 052150 064563 
.str2+0x4: 020151 071440 072150 062440 071545 061557 067144 020143 



_str2+0xl4: 
<b,20?4o4~8Cn 

_strl : 



_nimber : 



064141 071141 061564 062562 020163 072162 064556 063400 

052150 064563 020151 071440 This is 

060440 061550 060562 060543 a charac 

072145 071040 071564 071151 ter stri 

067147 01 nge<e'e'6'«'@a 



_f pt : 037640 

020151 
071545 
064141 
020163 

address not found in a. 

<b,20?4o4~8t8Ciia 



0710 



071440 
061557 
071141 
072162 
out file 



02322 e'e<eaH@'««edR 

052150 064563 ? S'S'This 

072150 062440 is the 

067144 020143 second c 

061564 062562 haracter 

064556 063400 



_strl : 


052150 


064563 


020151 


071440 


This is 


_strl+0x8: 


060440 


061550 


060562 


060543 


a cheurac 


_strl+OxlO: 


072145 


071040 


071564 


071151 


ter stri 


_strl+0xl8: 


067147 








01 


nge'e'e'e'e' 


.ntmiber : 












.number : 





0710 





02322 


«<@'eaH«'e'e 


_fpt: 












-fpt: 


037640 





052150 


064563 


? e'e'This 


_str2+0i4 : 


020151 


071440 


072150 


062440 


is the 


_str2+0xC: 


071545 


061557 


067144 


020143 


second c 


_str2+0xl4: 


064141 


071141 


061564 


062562 


haracter 


_str2+0xlC: 


020163 


072162 


064556 


063400 




address not found in a. 


out file 








<b,a?2b8t"2cn 













_strl : 



0x54 
0x69 
0x20 
0x73 
0x61 
0x63 
0x61 
0x61 
0x74 
0x72 



0x68 
0x73 
0x69 
0x20 
0x20 
0x68 
0x72 
0x63 
0x65 
0x20 



Th 

is 
i 
s 
a 
ch 
fir 
ac 
te 
r 



Figure G-7. adb Output Showing Fancy Formats 
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Patching 

To patch a file — that is, to change data in a file — use the write, w, or W 
request. To find the data you want to patch, you could either refer to it by its 
symbolic name, or you could find the data using locate, 1, or L. The request 
syntax for 1 and w are similar: 

?1 value 

?w value 

The request 1 matches two bytes; L matches four bytes. The request w 
writes two bytes; W writes four bytes. The value field in either request is an 
expression. Therefore, decimal and octal numbers, or character strings are 
supported. 

In order to modify (write to) a file, adb must be called with the -w option. For 
example, suppose you compiled the program shown in Figure G-6: 

$ cc -o fig6 figS.c 

To allow adb to write to the object file f ig6, invoke adb as follows: 

$ adb -w f ig6 

When used on object and core files, the locate command searches from dot 
until it finds the data or encounters an addressing error, which can occur 
when attempting to read past the end of the current segment. So, when using 
locate, be sure to position dot in the appropriate segment and at a starting 
location where the search will be successful. 
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For example, suppose you want to search for the string "This" in the program 
shown in Figure G-6, and replace it with "The ". If you issue the locate 
command, it starts searching (by default) at location 0x0 in the file's text 
segment. Since the string is contained in the data segment, the locate request 
fails: 

$ adb -w fig6 - Invoke adb with -w. 

executable file = fig6 

ready 

?L 'This^ Locate the string "This''. 

start adb cannot find the string. 

cannot locate value 

What you must do now is move dot to the starting address of the data 
segment, which you can determine using the map request: 

$m 

? map 'fig6' 

bl - 0x0 el = 0xCE8 fl = 0x40 

b2 = 0x1000 e2 = 0x1528 f2 = 0xD28 

/ map '-' 

bl = 0x0 el = 0x0 f 1 = 0x0 

b2 = 0x0 e2 = 0x0 f 2 = 0x0 

This indicates that the data segment starts at 0x1000 and ends at 0x1528. To 
search for "This", specify the starting address of the data segment when issuing 
the locate request: 

OxlOOO?L ^This^ Data segment starts at 0x1000. 
_strl It finds the address of strl. 

At this point, you could patch the string, replacing "This" with "The ": 

?W 'The ' 

_strl: 0x54686973 = 0x54686520 

To verify that it worked, use the s request to display the string at dot: 

?s 

_strl : The is a character string 
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As another example of the utihty of the patching facility, consider a C program 
that has an internal logic flag. The flag could be set by the user through adb 
and the program run. For example: 

$ adb a. out - 
:e argl arg2 
flag/w 1 
:c 

The :e request is used to start a. out as a subprocess with arguments argl and 
arg2. If there is a subprocess running adb writes to it rather than to the file so 
the w request causes flag to be changed in the memory of the subprocess. 



Anomalies 

Below is a list of some strange things that users should be aware of. 

1. Function calls and arguments are put on the stack by the link instruction. 
Putting breakpoints at the entry point to routines means that the function 
appears not to have been called when the breakpoint occurs. 

2. If a :S command is executed at a branch instruction, and the branch 
is taken, the command will act as a : c command. This is because a 
breakpoint is set at the next instruction and if is not reached, the process 
will not stop. 



Command Summary 



Formatted Printing 

? format print from a . out file according to format 

I format print from core file according to format 

= format print the value of dot 

?w expression write expression into a. out file 

/w expression write expression into core file 
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?1 expression locate expression in a. out file 

Breakpoint and Program Control 

b set breakpoint at dot 

c continue running program 

d delete breakpoint 

k kill the program being debugged 

r run a. out file under adb control 

s single step 

Miscellaneous Printing 

$b print current breakpoints 

$c C stack trace 

$e external variables 

$f floating registers 

$m print adb segment maps 

$q exit from adb 

$r general registers 

$s set offset for symbol match 

$v print adb variables 

$w set output line width 

Calling the Shell 

! shell-command run shelLcommand in the user's shell 

Assignment to Variables 

>name assign dot to variable or register name 



adb G-31 



Format Summary 

a the value of dot 

b one byte in hexadecimal 

c one byte as a character 

d two bytes in decimal 

f four bytes in floating point 

i MC68XXX instruction 

o two bytes in octal 

n print a newline 

r print a blank space 

s a null terminated character string 

nt move to next n space tab 

u two bytes as unsigned integer 

X hexadecimal 

Y date 

backup dot 

" . . . " print string 



Expression Summary 



Expression Components 



decimal integer 


e.g. 0d256 


octal integer 


e.g. 0277 


hexadecimal 


e.g. Oxff 


symbols 


e.g. flag .main 


variables 


e.g. <b 


registers 


e.g. <pc <dO 


C expression) 


expression group] 
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Dyadic Operators 

+ add 

subtract 

* multiply 

•/, integer division 

& bitwise AND 

I bitwise OR 

* round up to the next multiple 

Monadic Operators 

not 

* contents of location 
integer negate 
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This appendix describes a MC680xO assembly language sequence timing utility 
called atime. After you have developed and debugged assembly language code 
for a MC680a:0 processor (Series 300/400 computer), you can use atime to: 

■ Analyze the performance of the code (performance analysis mode). 

■ Determine the number of times each instruction is hit (execution profiling 
mode). 

■ Assert (verify) particular values in a code sequence to assure that various 
algorithms produce identical results (assertion listing mode). 



Continuing to Get Information 

Now that you know what atime does, please read the next three brief sections 
which: 

■ Describe prerequisites for using atime. 

■ Mention where to get additional or related information. 

■ Describe the sections in this manual. The descriptions of sections include 
suggestions for reading them. 
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Prerequisites 

The following items mention requirements for using atime: 

■ Your system needs /bin/ as and /bin/ Id, 

■ You have a sequence of assembler instructions you want to test and have 
developed an input file containing the assembler instructions and special 
atime instructions (more on this later). 

■ You must run atime on a quiescent single-user system to get valid resiilts. 
(The reason is that the utility returns empirically determined performance 
information.) 



Getting Additional Information 

In the HP-UX Reference Manual^ you might want to examine the following 
related pages: 

as(l) The as assembler 

ld{l) The link editor 

prof(l) A program that lets you display profile data 

gprof(l)A program that lets you display call graph profile data 



ly/lanual Contents 

The following paragraphs name and describe subsequent sections in the 
manual. They also suggest how to use the information. 

"Atime and Assembly Code" discusses the overall picture and shows how atime 
fits into the scheme of developing assembly code. (Skip this section if you 
already know what to expect or do not need to see this type of information.) 

"The Syntax with Examples" describes atime's syntax and options. Then, the 
section shows an example of running atime in performance analysis mode using 
an example of an input-file. (Some users may find that this section is all they 
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need. Remaining sections simply discuss the input-file, atime instructions, 
modes, output, and errors.) 

"The Input File" describes the four sections in an input-file. (Read this section 
to get more information if the previous examples did not provide enough 
information.) 

"The atime Instructions" describes the atime instructions, including examples. 
(Read this section as necessary to learn how to use the instructions.) 

"Performance Analysis Mode" describes performance analysis mode (the 
default mode). (Read this and the next two sections about modes according to 
your needs.) 

"Execution Profiling Mode" describes execution profiling mode (use the -p 
option). 

"Assertion Listing Mode" describes assertion listing mode (use the -1 option). 

"Recovering from Errors" describes error situations and how to handle them. 



Atime and Assembly Code 

In most cases, you develop assembly code to obtain maximum performance 
from, for example, a critical routine. During development, it may frequently 
be unclear as to which instruction, sequence of instructions, or algorithm can 
be executed most efficiently by the assembly instruction set. After you have 
developed and debugged two or more assembler instruction sequences, you can 
use atime to determine which sequence provides optimal performance. To do 
this, you run atime on each sequence and compare the results. 

This section shows how atime fits into the development of assembly code and h 

describes atimes features. (The remaining sections describe how to use them.) 
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The Overall Picture 

Figure H-1 shows where atime fits into the scheme of developing assembly 
language. It also shows the relationships between atime and the input-file, 
modes, and output. 



(1) Develop and debug 


functionally 


equivalent 


assembler 


instruction 


sequences 


to be timed 



I 



(2) Develop the input-file: 
file that has assembler 
and atime instructions. 



I 



(3) Run atime with 


desired 


options and the 


input-file 


in one of three 


modes 


and get related 


output 



£ 



Performonce 
Mode 



I 



I 



Execution 
Profiling Mode 



Output is on 

analysis 
of performance 



I 



1 



Assertion 
Listing Mode 



Output is 
profile 



I 



Output is an 
assertion listing 



Figure H-1. How atime Fits into Developing Assembiy Language 
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The atime Features 

The atime utility has the following features: 

■ You can check the timing (speed) of functionally equivalent assembler 
instruction sequences (e.g. finding the most significant bit in a data register). 

■ You can specify sets of input data and the relative probability that each of 
them will occur. 

■ The utility runs in one of performance analysis, execution profiling, or 
assertion listing modes. 

D Performance analysis mode (the default) causes a code sequence to execute 
many times in a loop with atime calculating and reporting the average 
time per iteration. 

D Execution profiling mode (use the -p option) makes atime run all or 
selected data sets and reports the number of times each executable 
instruction is hit. 

n Assertion listing mode (use the -1 option) causes atime to assert 
particular values in a code sequence for the purpose of assuring that 
various algorithms product identical results. You use this output to verify 
data for subsequent performance analyses and execution profiles. 

■ The utility provides output containing information you can compare with the 
output obtained from other runs to select the best sequence of assembler 
instructions. 
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Syntax with Examples 

This section shows the general syntax. Then, it describes the command line 
options and shows two examples of an input-file: bit .find and max_integers. 

The atime Syntax 

The syntax is: 

atime [options] input-file [output-file] 
Use options to control such things as: 

■ Specifying the mode 

■ Specifying an assertion data file 

■ Specifying a minimum number of timing iterations 

■ Turning off code sequence listing. 

The input-file has four sections with assembly code source instructions and 
atime instructions. 

The output-file goes to a specified file (if given) or to standard output if the 
name is- or is omitted. Otherwise, if the mode is performance analysis and the 
input-file has an output instruction, output goes to the file specified there. 

atime Options 

-aifile Specify an assertion data file to be used for assertion data. The file 

must have been created by a previous run of atime with the -1 
option. Only one -a option can be given and it will supersede any 
assert file instruction in the input-file. 

-icount Specify the minimum number of timing iterations where count 
is an integer in the range 1 through 2^^ - 1 (you get an error 
otherwise). When data sets exist, the actual value used equals 
or exceeds the given count because the number of iterations 
must be an integral multiple of the sum of counts in all dataset 
instructions. Only one -i option can be used and it supersedes 
any iterate instruction in the input-file. 
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-l[nam€] Print asserted values. If name is given, the code sequence is 

executed using the dataset called name in the input-file. Multiple 
-1 options are allowed. Omitting name prints assertions for all 
data sets. As each assert instruction in the input-file is executed, 
it prints its associated name and value. If an assertion file is 
specified by a -a option or an assert file instruction and there is 
a mismatch between the asserted value and the value in the file, 
that value is also printed. Also, an error is printed when a value 
is missing from the assertion file. Output goes to standard out 
unless you specify an output-file. An output instruction in the 
input-file is ignored. The output-file can be used as an assertion 
file in subsequent runs of atime. The -1 option cannot be used 
with the -p option. 

-n Turn off" listing the input-file to output. It is ignored if you use -p 

or -1. This is equivalent to nolist in the input-file. 

-■p[name] Do execution profiling by printing hit counts for each timed 

instruction where name specifies the data set to analyze from the 
input-file. Multiple -p options print counts as the sums for all 
designated data sets. Omitting name profiles all data sets. The -n 
and -i options are ignored. Do not use the -p option with the -1 
option. 

-ttext Specify text as the output title ( enclose multi-word titles in 

quotes, for example, "The First Sequence"). Leading and trailing 
blanks are ignored. Only one -t option can be given, and it will 
supersede any title instruction in the input-file. 



An Example of an Input-file 

This section shows two examples of input-files, which you create before running 
atime. The input-file contains assembler and atime instructions, and with 
command line options, it determines how atime works. Be sure to debug the 
assembler instruction sequence in the input-file. 
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A Rationale for Using atime 

The two instruction sequences below do the same thing (locate the most 
significant bit in the %dO data register on a 68000 processor). 
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Sequence One. 




movq 


&31,y.dl 


LI: btst 


y.dl,y.dO 


dbne 


y.dl,Ll 


Sequence Two. 




movq 


&31,y.dl 


cmp.l 


y,dO,&OxFFFF 


bhi.b 


LI 


movq 


&15,y.dl 


LI: btst 


y.di,y.do 


dbne 


y.dl,Ll 



The question is: "Which code sequence finds the bit in the least amount of 
time?" To get an answer, run atime and compare the returned information. 

A Complete input File 

The following input-file named bit_f ind helps you examine code that finds the 
most significant bit. The example shows the four sections of an input-file. To 
help you difierentiate instructions: 

■ A =^ precedes lines containing atime instructions. 

■ No =^ precedes lines having assembler instructions. 

You could, for example, run atime in performance analysis mode (the default) 
and send the output to /usr/stats/test-1 with: 

atime bit.find /usr/stats/test-1 

The four sections in the input-file, bit.f ind, look like this: 

atime initialization section 

=^ title Example 1 

=> comment The algorithm finds the most significant bit set 

=^ comment in an 8-bit number (original no. not destroyed) 

=> dataname $number 

=^ dataset bit?, 0x80 
=^ dataset bit6, 0x40 
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=^ 


dataset 


bits, 0x20 


=> 


dataset 


bit4, 0x10 


=^ 


dataset 


bits, 0x08 


=^ 


dataset 


bit2, 0x04 


=^ 


dataset 


bitl, 0x02 


=> 


dataset 


bitO, 0x01 


=^ 


dataset 


zero, 0x00 


=l> 


iterate 


5000000 


=> 


assert 


"assertfile" 


=^ 


output 


"logfile" 




/>f\/i £) liY^ii'f firilrt 'yrj'i'fi r^nrt o ^nj^-f- n /^tn 


=l> 


CC/Oc ITlllluliZQ 

Stack 


even 




mov.l 


&$number,*/,dO 


=^ 


code 


even 


=^ 


LiTfitu SGCZion 

time 






mov.l 


y.dO,-(y.sp) 




beq.b 


L2 




movq 


&31,y.dl 




LI: 






btst 


y.di,y.do 




dbne 


y.dl,Ll 




bra.b 


L3 




L2: 






movq 


&-i,y.di 




L3: 






mov.l 


(y.sp)+,y.do 




UCT IJ y bfiCllOTl 




=^ 


verify 




=^ 


assert. 1 


or iginal. value , y.dO 



H 



assert - 1 bit.number ,y,dl 
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A Second Example of an Input-file 

Here is another input -file called max_integers (the => points to atime 
instructions). 



=> 




-aume inmaiia 
title 


:aiion secuon 

Find the maximum of three integers 


=> 




comment 


Developed by 


T. 


R. Crew 


=^ 




comment 


June 9, 1987 






=> 




nolist 








=^ 




dataname 




$argl, $arg2, $arg3 


=^ 




dataset 


maxl(70). 




10, 4, 2 


=> 




dataset 


max2(35) , 




5, 11, 


=^ 




dataset 


max3(20). 




8, 13, 21 


=> 




iterate 


500000 






=> 




assert 


"assertfile" 






=^ 




output 


"logfile" 






=^ 




Idopt 


-Im -Ic 












-code initialization section 


— 





=^ 




stack 
mov.l 
mov.l 
mov.l 


even 

&$argl,y.dO 
&$arg2,y.dl 
&$arg3,y,d2 






=^ 





code 
-timed section 


even 






=> 




time 
c:mp.l 
bge.b 
exg 


y.do,y.di 

Ll 

y.do,y.di 








Ll: 


cmp.l 
bge.b 
exg 


y.do,y.d2 

L2 

y.do,y.d2 









L2: 


-verify section 








=^ 




verify 
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The Input File 

To use atime, you must create an input-file, which is specified in the atime 
command line. The input-file contains assembly code source instructions and 
special atime instructions, which look like assembler instructions. Together, 
these instructions let you obtain the timing data you need. The input-file has 
four sections, which are described next. 

Section One: atime Initialization 

Purpose: Set up the atime environment 

Location: First line of file to first line of assembly code or atime time, 

code, or stack instruction. 

Requirements: The following atime instructions can appear only in this 
section (the number in parentheses shows the maximum 
number of times an instruction can appear): 

■ assert file (1), comment, dataname (1), dataset, include, 
iterate (1), Idopt (1), nolist (1), output (1), title (1). 

■ dataname (if used) must precede dataset instructions. 



Section Two: Code Initialization 

Purpose: Set up environment for code to be timed 

Location: Follows the atime initialization section and continues up to 

the time instruction. 

Requirements: Note the following: 

■ Can contain any valid MC680a:0 assembler instruction. 

■ Can contain code even/odd, stack even/odd, or include 
instructions. 
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■ Can contain instructions using dataname names; each 
possible replacement for name must yield a valid MC680a;0 
instruction. 

■ You cannot make assumptions about the initial contents of 
registers. However, the stack pointer does point to a valid 
stack which can be used by code sequences. Be careful not 
to destroy data above this initial stack pointer. Registers 
(including stack and frame pointers) need not be saved and 
restored by the code sequence. 

Section Three: Timed 

Purpose: Time code sequence 

Location: The time instruction up to the verify instruction, or to the 

end of the file. 

Requirements: Any valid MC680arO assembler instruction or include. 

Section Four: Verify 

Purpose: Verify results 

Location: From verify instruction to the end of the file. 

Requirements: Any valid MC680a:0 instruction or include and/or: 
assert .{b|w|l} 

Input-file Requirements 

■ No branching among sections. Enter each section by falling into it from the 
end of the previous section. No checking occurs to report errors to the user. 
Trying to do this is undefined. 

■ Can use any valid MC680xO instruction where appropriate. 

■ Cannot use in4 macros or multiple instructions per line. 

■ Assembly code can reference external variables/routines if you provide for 
resolving them during linking. 
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The atime Instructions 

The input-file contains two types of instructions: standard assembler 
instructions (the code you want to test for speed, code to do initialization, and 
code to aid in verification of results); and atime instructions (instructions that 
dictate how atime does its work). 

Restrictions on atime Instructions 

■ Each instruction must be on a separate line. 

■ An instruction cannot be labeled. 

■ Comments cannot follow on the same line. 

■ If an instruction has a corresponding command line option, the option taJkes 
precedence. 

A Quicl( Look at the Instructions 

Table 1 lists the instructions; each instruction is described in detail following 
the table. 
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Table H-1. The atime Instructions 


Instruction 


Function/Purpose 


assert. {b|w|l} name, location 


Verify a datum 


assert file 


Specifies a file used for assertion data 


code odd 
code even 


Changes code to odd or even word alignment. 


comment text 


Writes comments to the output 


dataname name, ..., name 


Defines names of data entries in dataset 
instructions 


dataset 


Defines one data set 


include "file" 


Includes text from file 


iterate count 


Specifies minimum number of timing iterations 


Idopt options 


Specifies link editor options 


nolist 


Turns off listing input-file contents to 
output-file 


output file 


Specifies an output-file 


stack odd 
stack even 


Adjusts stack for odd or even word alignment 


time 


Designates section of code to be timed 


title text 


Specifies text used as the title for output 


verify 


Designates section of code used for algorithm 
verification 
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assert 

The syntax is: 

assert . < w ^ name , location 

il 

Use assert to verify a datum, which enables consistency checking to verify 
that you get identical results when you compare two or more code sequences 
for performance. 

assert in Performance Analysis/Execution Profiling IVIodes 

Executing an assert instruction during performance analysis or execution 
profiling modes searches for name in an assertion file. The size and value 
associated with the name is compared with that of the location in the assert 
instruction. A mismatch gives an error. You also get an error when name is 
missing from the assertion file; or when an assertion file is not specified with 
either the assert file instruction or the -a command line option. 

assert in Assertion Listing IVIode 

Executing assert in assertion listing mode prints the name and asserted value. 
If an assertion file is specified either with the assert file instruction or the -a 
command line option, the name is searched for there (you get an error if name 
is missing). The value in the file is printed when name exists and there is a size 
or value mismatch between it and the given location. 

Additional information about assert 

■ name identifies an asserted datum across atime executions. 

n For name., use an alphabetic character followed by or more alphanumeric 
or underscore characters. 

D For location, use any data addressing mode such as y,dO or 4(*/,a4,*/,d2.w) 

■ The non-optional b, w, and 1 suffixes to assert indicate a size of byte, word, 
and long (respectively). Do not use the b suffix with the address register 
direct mode. 

■ Asserted values are treated as 2's complement signed integers. 
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■ assert does not affect registers, stack, or condition codes. 

■ The size of this instruction in number of code bytes is not specified. 

■ An assert instruction must appear in the text segment and within the verify 
section of code. A given assert can be executed only once in a particular 
execution of a code sequence (ignores other attempts). 

Example: 

assert.l range, */,d2 

assert. w slip,-2(y,a6) 

tst.l 12 ('/.aS) 

smi y.dO 

assert.b sign,*/,dO 

assert file 

Syntax is: 

assert file 
Lets you specify a file used for assertion data. 

■ Can appear only once in the atime initialization section of the input-file. 

■ Foi file, use an absolute or relative pathname. 

■ Having the -a option in the command line supersedes assert in the 
input-file. 

■ You can use the -1 option to create an assertion file. 
Example: 

assert "assertdata" 

code odd I even 

The syntax is: 



code 



J odd 1 
\ even J 



H-16 atime 



Changes the code to odd or even word alignment. 

■ Must appear in the text segment in the code initialization section. 

■ Cannot be executed in the timed section, but can be executed just before 
entering that section. 

■ Does not affect registers, stack, or condition codes. 

■ The actual size of these instructions in number of bytes is unspecified. 
Example: 

code even 

comment 

Syntax is: 

comment text 
Lets you write any number of comments to the output. 

■ Must appear in the atime initialization section. 

Example: 

comment H. I. Que developed the code sequence 
comment using a new algorithm. 

dataname 

Syntax is: 

dataname name, name, ... ,name 
Defines the names of data entries in dataset instructions. 

■ The first name corresponds to first datum in all dataset instructions, second 
name to second datum, and so on. 

■ Can have only one dataname instruction; it must be in the atime 
initialization section and precede all dataset instructions. 

■ Number of names in a dataname instruction must equal the number of data 
entries in dataset instructions. 
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■ Names begin with $ followed by one or more alphanumeric or underscore 
characters. 

■ White space is ignored in the dataname list to allow specification of data sets 
in tabular form; whitespace cannot appear in a name. 

Example: 



dataname 




$time. 


$speed. 


$mass. 


$part 


dataset 


bicycle (100), 


Of 120.0, 


Of 32. 4, 


Of 55. 2, 


100 


dataset 


train (37) , 


Of 24. 14, 


Ofll4.8, 


0fl.5E4, 


16 


dataset 


boat. 


Of 71. 6, 


Of 37. 7, 


Of 2500.0, 


-6 


dataset 












Syntax is: 













ddLtaset nam€[( count) ], datum y datum y ... ydatum 

Lets you define one data set. The input-file must have at least one dataset 
instruction when you include a dataname instruction (see dataname). 

■ name identifies the data set. It permits specifying a data set with the -p 
option for execution profiling or with the -1 option for listing assertions. 

■ An optional count (greater than or equal to 1 and in parentheses) can follow 
name to specify the relative number of uses of the data set during timing 
(e.g. if one data set is 100 and another is 37, then, for each 100 executions 
of the first data set, the second set is executed 37 times). This lets you 
specify the probability of a data set being executed in a real environment. 
An omitted count defaults to 1. 

■ The sum of the counts in all dataset instructions (declared or defaulted) 
must have an integral multiple greater than or equal to the number of timing 
iterations and less than or equal to 2^^ — 1. 

■ You must give at least one datum 

■ The number of data items must be the same for aU dataset instructions and 
must match the number of names in the dataname instruction. 

■ Data items must not contain commas because they are treated as strings. 



H-18 atime 



$niass , 


$part 


Of 55. 2, 


100 


0fl.5E4, 


16 


Of 2500.0, 


-6 



■ Having a name from a dataname instruction appear in an assembly 
instruction replaces the name with the corresponding string from the 
dataset instruction currently considered. 

■ Whitespace between items in a dataset list is ignored to provide for 
specifying data sets in a tabular format. 

Example: 

dataname $time, $speed, 

dataset bicycle(lOO) , Of 120.0, 0f32.4, 

dataset train (37) , Of 24. 14, Of 114. 8, 

dataset boat. Of 71. 6, Of 37. 7, 

include 

Syntax is: 

include ''file" 
Includes text from file as follows: 

■ The file name can be an absolute or relative pathname. 

■ The include "file " instruction can appear anywhere in an input-file, but not 
in an include- file. 

Example: 

include "srcdata" 

iterate 

Syntax is: 

iterate count 

Specify the minimum number of timing iterations. (See count in dataset 
above for range.) 

■ With data sets, the value used for count is equal to or greater than the value 
given here because the number of iterations must be an integral multiple of 
the sum of the counts in all dataset instructions. 
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■ You get an error if the calculated iteration count falls outside the range; 
atime terminates. 

■ Only one iterate instruction can be used and it must appear in the atime 
initialization section. 

■ The -i option supersedes an iterate instruction. 

■ The default (not specified) timing iteration value is 1000000. 
Example: 

iterate 3000000 

Idopt 

Syntax is: 

Idopt options 

Specifies link editor options. An Idopt instruction passes its options to the 
link editor. Only one instruction can be used and it must appear in the atime 
initialization section. 

Example: 

Idopt ext_func.o -Im 

nolist 

Syntax is: 

nolist 
Turns oflf listing the input-file contents to the output-file. 

■ Only one instruction can be used and it must appear in the atime 
initialization section. 

■ Listing is turned off for the whole file and for any include- file(s). 

■ A nolist instruction is ignored when you use the -p or -1 options. 
Example: 
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nolist 

output 

Syntax is: 

output file 
Specifies an output-file where file can be an absolute or relative pathname. 

■ Output is appended to this file. 

■ Only one output instruction can be used and it must appear in the atime 
initialization section. 

■ An output instruction is ignored when you use the -p or -1 options. 
Example: 

output "/usr/stats/structmove" 

Stack odd I even 

The syntax is: 



stack 



fodd 1 
\ even j 



Adjusts the stack for odd or even word alignment by checking the current 
aUgnment and subtracting 2 (if necessary) from the stack pointer. 

■ Use only in the code initialization section. 

■ Because the stack pointer can change, memory locations referenced as offsets 

from the stack pointer can have their offsets changed. 

H 

■ These instructions do not affect condition codes or any registers other than 
the stack pointer. 

■ The size of these instructions in terms of number of code bytes is not 
specified. 

Example: 

stack odd 
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time 

Syntax is: 

time 
Designates a section of code to be timed. 

■ Timing of code begins with the line following the time instruction and 
continues up to a verify instruction or to the end of the file. 

■ There can be only one timed section and it must be whoUy within the 
program's text segment. 

Example: 



mov.l 


&$value , y.dO 


time 




mov.l 


•/.dO,y.dl 


swap 


y.dO 


add.l 


y.di,y.do 


mov.l 


y.do,(y.ao) 


verify 




movq 


&i,y.do 


and.l 


(y.ao),y.do 


title 

Syntax is: 




title text 




Specifies text used as a title for output 



■ Only one title instruction can be used and it must appear in the atime 
initialization section. 

■ A -t option supersedes a title instruction. 
Example: 

title ALGORITHM 1 - values saved on stack 
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verify 

Syntax is: 

verify 
Designates a section of code used for algorithm verification. 

■ The verify section begins with the line following the verify instruction and 
continues to the end of the file, 

■ This section normally contains one or more assert instructions. 
Example: 



mov.l 


&$value , Ad 


time 




mov.l 


y.dO,Xdl 


swap 


y.dO 


add.l 


'/.dl,XdO 


mov.l 


y.do,(y.ao) 


verify 




assert.l 


result, y,dO 



Performance Analysis Mode 

This default mode lets you analyze the performance of your assembly code. 

To analyze performance, an assembly code sequence is conceptually executed 
many times in a loop. The total time for execution (minus overhead) divided 
by the number of iterations gives an average execution time, which is reported 
to you. For sequences of code that do the same thing, the sequence having the 
lowest average has the greatest speed. 
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Using Command Line Options 

■ Valid options include: -a, -i, -n, and -t. 

■ Do not use -p or -1 because they cause atime to do execution profiling or 
assertion listing, respectively. 

■ Use an option only once in any order before the input-file name. 

Getting and Reading Output (tlie analysis) 

You get output as follows: 

■ appends to the output-file if you specified one in the command line. 

■ appends to the file in an output instruction if you specified one in the 
input-file. 

■ goes to standard out if you: 
□ did not specify anything. 

n used — (minus) for the output-file in the command line. 

An Example 

The following example with annotations shows the order and appearance of the 
output. 

Separator line between sequences 

Find the Maximum of Three Integers Title if given by -t or title 

Developed by T. R. Crew Comment in 

June 9, 1987 comment instructions 

name: robert Login name 

machine : systeml Computer hostname 

date: Tue Jun 9 16:33:04 1987 Date (day, month, date, time, 

year) 

size: 12 bytes Size of timed section in bytes 

instructions: 6 Number of executable instructions 

in timed section 

iterations : 50000 Number of actual iterations 

avg. time: 780.408 nsec average execution time 
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(Note: The entire contents of The input-file (including text from 

the input-file and any include-files) when -n and nolist 

include-file(s) appears here.) are not given. 

Showing the Average Time 

The average time is presented according to the following format: 

0.0 sec for less than 1 nsec 

ddd.ddd nsec for 1 nsec to 999.999 nsec 

ddd.ddd usee for 1 //sec to 999.999 //sec 

ddd.ddd msec for 1 msec to 999.999 msec 

dd.ddd sec for 1 sec to 59.999 sec 

dd min dd.ddd sec for 1 min to 59 min, 59.999 sec 

dddd hr dd min dd.ddd sec for 1 hour or greater 



Execution Profiling IVIode 

The execution profiling mode of atime gives you a profile by executing a code 
sequence, tallying how many times each instruction is executed. Here is the 
overall scheme: 

■ Given a list of data sets for doing execution profiling, the number of times 
a particular data set is executed in the process of tallying instruction hits 
equals the count associated with its particular dataset instruction (not 
specifying count defaults it to 1; and if there are no data sets, the code 
sequence executes once). 

■ The mode tallies those instructions recognized as executable by the MC680a;0 
assembler. It excludes other instructions such as data initialization (e.g. 
byte), symbol definition (e.g. set), and aHgnment (e.g. lalign). 

■ The mode aids in defining data sets. In setting up code for timing, you will 
usually specify at least one data set to execute a particular set of paths in 
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the code. Having the execution printing mode on for that data set verifies 
that the set of paths is what is executed. 

■ After defining data sets, atime can determine if all code will be executed by 
running execution profiling for all data sets collectively. When you notice 
certain instructions not getting hit, you can add more data sets to cover 
those cases. 

Using Command Line Options 

■ You must have at least one -p option to use the mode. 

■ Other options include -a, -i, -n, and -t; but -i and -n have no effect. Use 
at most one of each of the "other" options in any order before the input-file 
name. Duplicate usage of a particular option prints a warning message and 
ignores all but the first usage. 

■ Using -1 causes an error and terminates execution. 

Getting and Reading Output (tlie profile) 

You get output as follows: 

■ appends to the output-file if specified in the command line. 

■ goes to standard out if you did not specify anything or you used — for the 
output-file. 

■ ignores an output instruction in the input-file. 

An Example 

The following example shows how execution profiling mode prints information. 

Separator line between sequences 

Find the Maximum of Three Integers Title if given by -t or title 

Developed by T. R. Crew Comment in 

June 9, 1987 comment instructions 

name: robert Login name 

machine : systeml Computer hostname 

date: Tue Jim 9 16:33:04 1987 Date (day, month, date, time. 



year) 
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The remaining output has dataname and dataset lines as they appeared in 
the input-file and profile information in two fields: number of executions and 
executed assembler instructions. 

$argl, $arg2, $arg3 





maxl(70). 


10, 4, 


2 




max2(35). 


5, 11, 







max3(20), 


8, 13, 


21 


125 


cmp.l 


y.do,y.di 




125 


bge.b 


LI 




55 


exg 


y.d0,'/.dl 




125 LI: cmp.l 


y.do,y.d2 




125 


bge.b 


L2 




20 


exg 


y.do,y.d2 





L2: 



Examining Assertion Listing IViode 

The assertion listing mode of atime lets you determine that results are 
identical for every code sequence variation. 

■ Upon executing a code sequence for a specified data set, each assert 
instruction prints its asserted value. If an assertion file is specified, the value 
is checked against its corresponding value in the file; and on a mismatch, the 
value in the assertion file is also printed. Not having a value in the assertion 
file prints an error message. 

■ Besides printing code sequence results, output of an assertion listing can be 
put into a file and used as the assertion file in subsequent runs of atime. 

H 

Using Command Line Options 

■ You must specify at least one -1 option. 

■ Other valid options include: -a, -i, -n, and -t, but -i and -n have no effect. 
Use at most one each of valid "other" options. Any order is accepted; the 
options must appear before the input-file. Having more than one of any 
particular option generates a message and atime ignores the extras. 
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■ Using -p generates an error and terminates execution. 

Getting and Using Output 

You get output as follows: 

■ The information in the first six lines is the same as that shown for other 
modes. 

■ The assertion listing information begins with dataset: followed by the name 
of the data set (each data set requires a name). 

■ Then, you see each datum in the data set as its name followed by its value. 

■ On executing a code sequence, each asserted value is printed as its name 
followed by its value. 

■ If an assertion file is specified and it has a diflFerent corresponding value, that 
value is also printed. 

■ You get MISSING when a value is missing from the assertion file. 

■ Asserted values have a size suffix. 

An Example 

The following example shows how assertion listing mode prints information. 

Separator line between sequences 

Find the Maximum of Three Integers Title if given by -t or title 

Developed by T. R. Crew Comment in 
June 9, 1987 comment instructions 

name: robert Login name 

machine : systeml Computer hostname 

date: Tue Jun 9 16:33:04 1987 Date (day, month, date, time, 

year) 

The remaining output shows the assertion information according to the above 
description on getting output, 

dataset: maxl 

$argl 10 

$arg2 4 
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$arg3 


2 




max 


10.1 


dataset : 


inax2 






$argl 


5 




$arg2 


11 




$arg3 







max 


11.1 


dataset : 


max3 






$argl 


8 




$arg2 


13 




$arg3 


21 




max 


21.1 



Recovering from Errors 

The atime utility provides self-explanatory error messages. In addition, you 
can get error messages from the assembler or link editor. When assembly fails, 
an intermediate, temporary file is retained with the error message indicating 
its name. The file is important because it contains comments that help you 
correlate assembly errors with errors in the input-file. 

Tracking Errors 

Recall that bit_f ind, the input-file for finding the most significant bit, 
contained the line: 

btst y.dl,y.dO 

Suppose, for example, the line had a typing mistake and read: 

btst y,ai,y,do 

Running atime on this file would return an error message similar to: 

as error: "/usr/tmp/aaaa22982" line 37: sjrntax error 

(opcode/operand mismatch) 
ERROR: cannot assemble file: •7usr/tmp/aaaa22982" 

Looking at lines 36 and 37 in /usr/tmp/aaaa22982, you would see: 
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# "bit.find", line 25 
btst */,al,y,dO 

This information tells you the error is in line 25 in the input-file called 

bit .find. Knowing this, you can locate the error in the original input-file and 

make necessary corrections (i.e. change '/.al to */,dl). 

Remember to remove the temporary file when you finish using it. 

Data Set Errors 

Suppose you made a typing error for data set bitS by typing: 

dataset bit5, 0x2X 

which will create the erroneous instruction: 

mov.l &0x2X,y,d0 

You would get an error similar to: 

as error: "/usr/tmp/aaaa22997" line 116: syntax error 

(op code /operand mismatch) 
as error: "/usr/tmp/aaaa22997" line 116: sjrntax error 
ERROR: cannot assemble file: '7usr/tmp/aaaa22997" 

The code in /usr/tmp/aaaa22997 around line 116 could look like: 

Zcode2: # "bit.find", line 18, dataset: bitS 

# mov.l &$number,y,dO 

mov.w y.cc, Zcodecc 

mov.l (y,sp) + , Zcodesp 

addq.w &4,y,sp 

mov.w Zcodecc, y.dO 

mov.l &0x2X,y.d0 

mov.w y,cc, Zcodecc 

mov.l Zcodesp, -(y.sp) 

mov.w Zcodecc, -(y.sp) 

rtr 

Backing up from line 116 and looking at the comments, you see: 

■ The file is bit_f ind. 
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■ The error occurred on line 18, which is: 

mov . 1 &$number , */,dO 

■ The offending data set is called bit5. 

Assert instruction Errors 

Suppose you made an error in one of the assert instructions: 

assert . 1 original.value ,*/,d9 
Running atime would return: 

as error: "/usr/tmp/aaaa23012" line 58: 

invalid register symbol (*/«d9) 
as error: "/usr/tmp/aaaa23012" line 58: syntax error 

(opcode/operand mismatch) 
as error: "/usr/tmp/aaaa23012" line 58: S3rntax error 
ERROR: cannot assemble file: '7usr/tmp/aaaa23012" 

Lines 57 and 58 in /usr/tmp/aaaa23012 look like: 

mov.w y,cc,__Z # "bit.find", line 33 

mov.l */.d9, ZEA # assert. 1 original_value,*/d9 

Again, the comments indicate the file, offending line, and instruction in the 
original file. 

Some Notes About Error Recovery Procedures 

Looking back at the three examples of error recovery, you see a similar pattern: 

■ Examine the error messages, looking for clues, 

■ Look at the temporary file according to implied line numbers. " 

■ Study the code and comments to find the error. 

■ Correct the error in the appropriate files. 

Atime catches errors associated with setting up the analysis environment. With 
assertions, it also detects differing results between code sequences. In addition, 
certain types of errors are caught by the assembler or link editors. Beyond this, 
there are particular runtime errors that cannot be tracked down effectively 
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except outside of using atime. Such errors include bad pointer dereferences 
and executing infinite loops. In all cases, it is best to run atime only on code 
sequences you have thoroughly tested beforehand. 
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abs, 4-4, 6-12 

absolute addressing modes, 7-4 

absolute expressions, 4-1, 7-4 

absolute integer constants, 4-4 

absolute long addressing, 7-4 

absolute offsets, 5-6 

adb 

+ (addition operator), G-2 

advanced breakpoint usage, G-15-17 

anomalies, G-30 

& (bitwise AND operator), G-2 

I (bitwise OR operator), G-2 

! command, G-2 

$ command, G-2 

/ command, G-2 

: command, G-2 

; command, G-2 

= command, G-2 

? command, G-2 

commands (requests), G-2 

rCTRLV fcl, G-2 

dot (.) location counter, G-2, G-3, 
G-4, G-16 

dot(.) location counter, G-2 

expressions, G-2 

format letters, G-3 

'/. (integer division operator), G-2 

internal arithmetic, G-2 



invoking, G-1 
maps, G-18-22 

* (multiplication operator), G-2 
operators, G-2 

registers, G-22-24 

# (round up to the next multiple, G-2 
- (subtraction operator), G-2 
symbohc address, G-2 
terminating adb commands, G-2 

" (unary not), G-2 

variables, G-22-24 
addition, 4-2 
addressing modes, 7-4 
address mode syntax, 7-1 
address register, 2-5 
$ALIAS directive, C-8 
align, 6-8 

alignment pseudo-ops, 6-8 
align pseudo-op, 6-9 
-a lisifile option, 1-9 
allow_plsub, 6-10 
allow_plstib pseudo-op, 4-7 
-A option, 1-8 
a. out, 1-8, 6-12 
archive libraries, 1-10 
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-a option, 1-9 

-A option, 1-8 

command options, 1-8 

-d option, 1-9 

introduction, 1-1 

invoking from compilers, 1-11 
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-1 option, 1-9 

-L option, 1-9 

-m option, 1-9 

-o option, 1-8 

running, 1-7 

source files, 1-8 

syntax, 1-7 
as(l), 1-4 
ASCII character in character constants, 

2-8 
asciz, 6-4 

asciz pseudo-op, 2-10, 6-4 
assembler listing options, 9-1 
Assembler operation, 1-11 
assembly language expressions, 4-1 
assembly language interfaces to high-level 

languages, C-1 
assembly language program sections, 

3-1 
assembly language syntax, 2-1 
assembly listing, 1-8 
assembly source file, D-3 
assert instruction of atime, H-15, H-16 
associativity rules, 4-3 
as syntax, 2-1 
a.stamp, 1-10, 6-12 
astrn, E-1 
atime 

assertion listing mode , H-27 

assertion listing mode output, H-28 

error recovery, H-29 

execution profiling mode, H-25 

execution profiling mode output, H-26 

features, H-5 

input-file, H-11 

input-file code initialization, H-11 

input-file example, H-7 

input-file initialization, H-11 

input-file timed section, H-12 

input-file verify section, H-12 

instructions, H-13 



introduction, H-1 

options, H-6 

output, H-24 

overview, H-3 

performance analysis mode, H-23 

performance analysis mode output, 

H-24 
prerequisites, H-2 
rationale for use, H-7 
restrictions on atime instructions, 

H-13 
syntax, H-6 

table of instructions, H-13 
atime examples 
input-file, H-7 
output from assertion listing mode, 

H-28 
output from execution profiling mode, 

H-26 
output from performance analysis 

mode, H-24 
atime instructions 
assert, H-15, H-16 
code even, H-16 
code odd, H-16 
comment, H-1 7 
dataname, H-1 7 
dataset, H-1 8 
include, H-1 9 
iterate, H-19 
Idopt, H-20 
nolist,H-20 
output, H-21 
stack even, H-21 
stack odd, H-21 
time, H-22 
title, H-22 
verify, H-23 
atime modes 

assertion listing, H-27 
execution profiling, H-25 
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execution profiling , H-5 

output from assertion listing mode, 

H-28 
output from execution profiling mode, 

H-26 
output from performance analysis 

mode, H-24 
performance analysis, H-23 
performance analysis , H-5 
atime output 

assertion listing mode, H-27, H-28 
execution profiling mode, H-25, H-26 
performance analysis mode, H-24 
atrans, E-1 

B 

backslash, 2-8, 2-9, 2-10 

backspace, 2-9 

binary operators, 4-2 

bit shift right, bit shift left, 4-2 

bitwise AND, 4-2 

bitwise exclusive-OR, 4-2 

bitwise OR, 4-2 

branch oflfsets, 5-2 

breakpoints 

advanced usage in adb, G- 15-1 7 

effect on dot, G-16 

setting in adb, G-9-15 
bss segment, 3-1 
byte, 6-4 
byte pseudo-op, 2-10, 6-4 

C 

C, C-2, C-8 

cache address register, 2-6 

cache control register, 2-6 

call-by-reference, C-8, C-13, C-14 

call-by- value, C-8, C-13, C-14, C-15 

calling sequence, C-4 

calhng sequence conventions, C-4 

carriage return, 2-9 



case sensitivity, 2-4 

CBD support pseudo-ops, 6-14 

cc compiler, 1-11 

C compiler, 1-11 

C compilers, C-4 

cop, 2-3 

C functions, C-8 

C functions returning 64-bit double 

values, C-10 
character constants, 2-8 
C language, C-1 
C.NEAR, 6-11 
C_NEG_INF, 6-11 

code even instruction of atime, H-16 
code odd instruction of atime, H-16 
comm, 6-7 

comment instruction of atime, H-17 
comments, 2-2, 2-3 
comm pseudo-op, C-1 
comparison instructions, 1-6 
compatibility issues, A-1 
compiler-generated local symbols, 1-9 
condition code register, 2-5 
conformant arrays, C-17 
constants, 2-8, 4-2 
copy value mechanism, C-14 
copy value parameters, C-15 
core file, G-1, G-6 
count l.s, D-1 
C_POS_INF, 6-11 
crtO.o, A-3 
C source file, D-2 
C structure- valued functions, C-11 
C.TOZERO, 6-11 
(CTRL}©, 



G-2 
cvtnxun, 6-11 
cvtnum(3C) routine, 2-11 

D 

dabs, 4-4 

data initialization pseudo-ops, 6-4 
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datancune instruction of atime, H-17 

data register, 2-5 

data segment, 3-1 

dataset instruction of atime, H-18 

debugging assembly language programs, 

1-9 
debugging C programs, G-5-9 
demand-loadable executables, debugging, 

G-19 
destination function code register, 2-6 
determining expression type, 4-4 
diagnostics, B-1 
displacement, 1-9 
displaying information, G-3-5 
division, 4-2 
dntt, 6-14 
diit_TYPE, 6-14 
-d option, 1-9 
dot (.), 3-2 
dot identifier, 2-4 
double, 4-8 

double floating-point expressions, 4-8 
double pseudo-op, 4-8, 6-4 
double pseudo-ops, 6-11 
double quote, 2-9 
dumps, formatted, G-24-27 
dynamically loaded libraries, 1-10 



EA, 8-2 

effective address, 8-2 

end_plsub, 6-10 

error messages, B-1 

error recovery with atime, H-29 

evaluating expressions, 4-5 

even, 6-8 

examples 

atime input-file, H-10 

atime input-file code initialization, 
H-8 

atime input-file initialization, H-8 



atime input-file timed section, H-8 

atime input-file verify section, H-8 

executing atime, H-8 
executable file formats, G-18 
executable programs, 1-7 
expression 

absolute, 4-1 

external, 4-1 

relocatable, 4-1 
expression evaluation, 4-5 
expression rules, 4-2 
expressions, 4-1 
expression types, 4-1, 4-4 
ext, 4-4 
extended, 4-8 

extend pseudo-op, 4-8, 6-4 
extend pseudo-ops, 6-11 
external expressions, 4-1, 4-2 
externally defined symbols, C-1 



f77 compiler, 1-11 

fabs, 4-4 

file names, assembly language source, 

1-8 
filler bytes, 3-3 
float, 6-4 
floating-piont condition code 

designations, 8-17 
floating-point accelerator registers, 2-7 
floating-point constants, 2-10, 4-8 
floating-point control register, 2-7 
floating-point data register, 2-7 
floating-point directives, 6-1 
floating-point expressions, 4-8 
floating-point format, IEEE, 2-11 
floating-point instruction address 

register, 2-7 
floating-point pseudo-ops, 6-11 
floating-point status register, 2-7 
float pseudo-op, 4-8, 6-4 
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float pseudo-ops, 6-11 

forcing small displacements (-d), 7-8 

format, executable file, G-18 

format letters in adb, G-3 

formatted dumps, G-24-27 

form feed, 2-9 

Fortran, C-8 

FORTRAN, C-1 

FORTRAN CHARACTER functions, 

C-12 
FORTRAN CHARACTER parameters, 

C-12 
FORTRAN compiler, 1-11, C-2 
Fortran compilers, C-4 
FORTRAN C0MPLEX*16 functions, 

C-13 
FORTRAN C0MPLEX*8 functions, 

C-13 
FORTRAN functions, C-8 
FORTRAN functions returning 64-bit 

double values, C-10 
FORTRAN subroutines, C-11 
FPA base register, 6-11 
FPA macros, 8-29 
f par eg, 6-11 
fpid, 6-11 
fpmode, 6-11 
fprintf , D-1 

frame pointer address register, 2-5 
frame pointers, C-2 
function result registers, C-3 

G 

global, 6-7 

global pseudo-op, C-1 

global symbols, 1-9 

H 

hexadecimal dump, 1-8 
high-level language interfaces, C-1 
horizontal tab, 2-9 



HP 98248 Floating-Point Accelerator 

Manual, 1-4 
HP 98248 floating-point registers, 2-5 
HP 98248 registers, 2-7 

I 

identifier, 2-4 

identifiers, 4-2 

IEEE floating-point format, 2-11 

inunediate operand, 8-2, 8-3 

immediate operand syntax, 7-3 

implicit alignment, 3-3 

include instruction of atime, H-19 

INF (INFinity), 2-11 

initialized data, 3-1, 6-1 

input-file 

atime code initialization, H-11 
atime initialization, H-11 
atime requirements, H-12 
atime timed section, H-12 
atime verify section, H-12 

instruction mnemonic, 2-4 

instructions, 3-1 

instruction sets, 8-1 

instructions for atime, H-13 

integer constants, 2-8 

interfacing to C, D-1 

intermediate variables, C-14 

internal pseudo-op, 6-14 

interrupt stack pointer, 2-6 

introduction to atime, H-1 

iterate instruction of atime, H-19 



label reference, 8-2 
labels, 2-2, 3-3, 4-1 
label values, 1-11 
lalign, Q-8, 6-9 
lalign pseudo-op, 5-6 
language routines, C-1 
Icomm pseudo-op, 6-4 
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Id, 1-7 

Idopt instruction of atime, H-20 

libraries 

archive, 1-10 

dynamically loaded, 1-10 

shared, 1-10, 6-14 
link, G-30 
linker, 1-7, 7-4 

linker symbol table (LST), 1-9 
linking, C-1 
listfile, 1-9 
listfile option, 9-1 
listing, generating to standard output 

,1-8 
listing, saving to a file, 1-9 
local symbols, 1-9 
local symbols, user-defined, 1-9 
location counter, 3-2 
location counters, 3-3 
location counter update, 3-3 
long, 6-4 
long offsets, 5-2 
long pseudo-op, 3-3, 6-4 
-1 option, 1-9 
-L option, 1-9 

M 

m4 macro preprocessor, 1-9 

macro preprocessor, m4, 1-9 

magic number, 1-10 

maps, adb, G-18-22 

master stack pointer, 2-6 

MC68000 registers, 2-5 

MC68010 addressing compatibihty, 1-9 

MC68010 processor, A-2 

MC68010 registers, 2-5, 2-6 

MC68020/30/40 addressing mode 

optimization, 7-6 
MC68020/30/40 processor, A-2 
MC68020/30 registers, 2-6 



MC68020 32-Bit Microprocessor User's 

Manual, 1-4 
MC68020 registers, 2-5 
MC68030 32-Bit Microprocessor User's 

Manual, 1-4 
MC68030 registers, 2-5 
MC68040 32-Bit Microprocessor User's 

Manual, 1-4 
MC68040 registers, 2-5 
MC680xO instruction sets, 8-1 
MC68881/2 instruction sets, 8-17 
MC68881/2 processor, A-2 
MC68881 Floating-Point Coprocessor 

User's Manual, 1-4 
MC6888 1 registers, 2-5, 2-7 
MC68882 registers, 2-7 
modulo, 4-2 
-m option to as, 1-9 
multiplication, 4-2 

N 

NAN (Not A Number), 2-11 

negation, 4-2 

newline (line feed), 2-9 

nolist instruction of atime, H-20 

nonterminating lines, backslash, 2-10 

NULL character, 2-10 



object code, 3-1 

object file, naming the output, 1-8 

offset, 8-3 

-o option, 1-8 

Operand addressing modes, 1-11 

operand size, 5-1 

operators, 4-2 

options for atime, H-6 

order of operands, 1-6 

output instruction of atime, H-21 

output object file, 1-8 

overriding precedence, 4-4 
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packed, 4-8 

packed pseudo-op, 4-8, 6-4 

packed pseudo-ops, 6-11 

padding, 3-3 

parameter-passing rules, C-14 

parentheses, 4-4 

Pascal, C-1, C-2 

Pascal compilers, C-4 

Pascal conformant arrays, C-17 

Pascal functions return values, C-15 

Pascal Language System (PLS), E-1 

Pascal result area, C-17 

Pascal user-defined functions, C-13 

Pascal "var string" parameters, C-18 

passing large value parameters, C-14 

passing parameters, rules for, C-14 

pass one, 1-11, 4-7, 5-7 

Pass-One absolute, 1-11 

pass-one absolute expression, 4-7 

Pass two, 1-11 

patching, G-27-30 

PC-relative addressing mode, 7-4 

performance analysis mode of atime, 

H-23 
PIC, 1-10 
pointers, C-2 

position-independent code (PIC), 1-10 
precautions, 1-6 
precedence override, 4-4 
precedence rules, 4-3 
predefined assembler names, 2-4 
preliminary code, 1-11 
prerequisites for running atime, H-2 
program counter, 2-5 
pseudo-op 

lalign, 5-6 
pseudo-op mnemonic, 2-4 
pseudo-ops, 6-1 

abs, 6-12 

align, 6-8 



allow_plsub, 4-7, 6-10 
asciz, 2-10, 6-4 
byte, 2-10, 6-4 
comm, 6-7 
dntt, 6-14 
dnt-TYPE, 6-14 
double, 2-10, 4-8, 6-4 
eiid.plsub, 6-10 
even, 6-8 

extend, 2-10, 4-8, 6-4 
float, 2-10,4-8, 6-4 
f par eg, 6-11 
fpid, 6-11 
fpmode, 6-11 
global, 6-7 
lalign, 6-8 
Icomm, 6-4 
long, 3-3, 6-4 
packed, 2-10, 4-8, 6-4 
set, 6-7 
short, 6-4 
sltnoxmal, 6-14 
sltspecial, 6-14 
space, 6-4 
vt, 6-14 



recovering from atime errors, H-29 
register conventions, C-2 
register identifier, 2-5 
registers, adb, G-22-24 
register suppression, 2-6 
register variables, C-3 
reglist, 8-3 
rel, 4-4 

relocatable expressions, 4-1 
relocatable object code, 1-7 
Relocatable object file, 1-11 
relocatable object files, 1-10 
relocatable value, 4-1 
RELOC_MAGIC, 1-10 
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restrictions on atime instructions, H-13 
restrictions on span-dependent 

optimization option, 5-6 
result area, C-17 
rules for associativity, 4-3 
rules for expressions, 4-2 
rules for precedence, 4-3 
run-time check. A- 3 
run-time stack pointer, C-2 
run-time stack use, C-2 



+s compile line option, 1-10 
scratch registers, C-2 
segments, 3-1 

bss, 3-1 

data, 3-1 

text, 3-1 
segment selection pseudo-ops, 6-1, 6-2 
semantic error, B-1 
set, 6-7 

setting breakpoints in adb, G-9-15 
.s files, 1-8 

shared executables, debugging, G-19 
shared libraries, 1-10 
shared library pseudo-ops, 6-14 
shared library version date, 6-14 
shlib_version pseudo-op, 6-14 
short, 6-4 

short displacement, 1-9 
short pseudo-op, 6-4 
SIGILL interrrupt, A-3 
signal 

interrupt, G-17 

quit, G-17 
signal SIGILL, A-3 
simplified instructions, 1-6 
single-line diagnostic message, B-1 
single quote, 2-9 
size of operands, 5-1 
sltnormal, 6-14 



sltspecial, 6-14 

small displacements, 7-8 

source file, 1-8 

source function code register, 2-6 

source translators, E-1 

space pseudo-op, 6-4 

span-dependent directives, 6-1 

span-dependent optimization, 1-10, 4-5, 

4-7, 5-1, 5-2, 5-6, 6-10 
span-dependent optimization option 

restrictions, 5-6 
special characters, 2-8, 2-10 

backslash, 2-9 

backspace, 2-9 

carriage return, 2-9 

double quote, 2-9 

form feed, 2-9 

horizontal tab, 2-9 

newline (line feed), 2-9 

single quote, 2-9 

vertical tab, 2-9 
special reserved symbols, 2-4 
specific forms, 1-7 

stack even instruction of atime, H-21 
stack odd instruction of atime, H-21 
stack pointer, 2-5 
stack pointers, C-2 
standard error output (stderr), B-1 
statements, 2-2, 2-3 
static link, C-16 
static links, C-14 
status register, 2-5 
St din, 1-8 
stdont, 1-8 
string constants, 2-10 
structures, keeping together in memory, 

6-14 
subtract instructions, 1-6 
subtraction, 4-2 
subtraction instructions, 1-6 
suppressing address registers, 2-6 
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suppressing program counters, 2-6 

suppressing registers, 2-6 

suppressing warning messages, 1-9 

symbol definition pseudo-ops, 6-7 

symbolic address in adb, G-2 

symbolic offsets, 5-6 

symbol subtractions, 5-7, 6-10 

symbol table, 2-4 

syntactic error, B-1 

syntax, assembly language, 2-1 

syntax for atime, H-6 



temporary registers, C-3 

text segment, 3-1 

text segments, 5-1 

time instruction of atime, H-22 

title instruction of atime, H-22 

translators, E-1 

type rules for expressions, 4-4 

U 

unary operators, 4-2 
unary plus, 4-2 
undefined external, 4-2 
undefined external addresses, 7-4 
undefined symbols, 1-9 
uninitialized data, 3-1 



updating the location counter, 3-3 
user-defined identifiers, 2-4 
user-defined local symbols, 1-9 
user stack pointer, 2-5 



variables, adb, G-22-24 

"var" parameters, C-14 

var string parameters, C-18 

vector base register, 2-6 

verify instruction of atime, H-23 

Version pseudo-op override, 1-10 

version pseudo-ops, 6-12 

version stamp, shared libraries, 6-14 

vertical tab, 2-9 

vt, 6-14 

W 

warning messages, suppressing, 1-9 
width, 8-3 

X 

xdb{l), 6-14 



zero register, 2-6 

+z or +Z compile line option, 1-10, 6-14 
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